swagger “>-”有什么作用?[duplicate]

vngu2lb8  于 2023-03-18  发布在  其他
关注(0)|答案(1)|浏览(114)

此问题在此处已有答案

How do I break a string in YAML over multiple lines?(10个答案)
What's the difference between |, > and >- in OpenAPI YAML descriptions?(2个答案)
8天前关闭。
我发现了一些内部的async-api模式,看起来像下面的例子:

schemas:
    Example:
      type: object
      allOf:
        - $ref: '#/components/schemas/Foo'
        - type: object
          properties:
            bar:
              type: string
              description: >-
                Some description

>-在这种情况下是什么意思?我找不到任何关于此的文档。official specification只提到了|字符,它表示一个多行字符串。

yquaqz18

yquaqz181#

|>都用于多线字符串。

块样式指示符:块样式指示块中的换行符应该如何表现。如果您希望它们保留为换行符,请使用literal样式,由竖线指示(|)。如果要将它们替换为空格,请使用folded样式,用右尖括号表示(>).(要使用折叠样式获得换行符,请通过放入两个换行符来保留空行。具有额外缩进的行也不会折叠。)
阻塞咀嚼指示器:chomping指示器控制字符串末尾的换行符应该发生什么。默认值为clip,在字符串末尾放置一个换行符。要删除所有换行符,strip通过在样式指示器后面放置一个减号(-)来删除它们。clip和strip都忽略块末尾实际上有多少换行符;要保留,请在样式指示符后添加加号(+)。

源代码,因此您可以很容易地看到这些语法之间的差异:https://yaml-multiline.info/
另请参见How do I break a string in YAML over multiple lines?以获得深入的解释。

相关问题