Lines

Lines.FromBinary

Lines.FromBinary(
    binary as binary, 
    optional quoteStyle as nullable number, 
    optional includeLineSeparators as nullable logical, 
    optional encoding as nullable number
) as list

将二进制内容按照指定编码转成文本后再以换行符分隔拆分成列表。

回车符（#(cr)）、换行符（#(lf)）、回车换行符（#(cr,lf)）会被认为是单个分隔符，但是换行回车符（#(lf,cr)）会被认为是两个符号。

参数quoteStyle用于指定引号的行为，可以是QuoteStyle.Type枚举值或数字：

• QuoteStyle.None：默认值。引号没有特殊意义。
• QuoteStyle.Csv：按照CSV的方式引用。引号是整体内容，如果引号内包含换行或回车，也属于引号内的内容。

参数includeLineSeparators用于指定结果是否包含分隔符。默认值false。

参数encoding用于指定二进制转文本的编码方式，取值为TextEncoding.Type枚举值或数字。默认值为TextEncoding.Utf8（65001）。

Lines.FromBinary(#binary({0x41, 0x0D, 0x61, 0x0A, 0x42}))
Lines.FromBinary(
    #binary({0x41, 0x00, 0x0D, 0x00, 0x61, 0x00, 0x0A, 0x00, 0x11, 0x62}), 
    null, 
    false, 
    TextEncoding.Unicode
)

Lines.FromText

Lines.FromText(
    text as text, 
    optional quoteStyle as nullable number, 
    optional includeLineSeparators as nullable logical
) as list

将文本以换行符分隔拆分成列表。

回车符（#(cr)）、换行符（#(lf)）、回车换行符（#(cr,lf)）会被认为是单个分隔符，但是换行回车符（#(lf,cr)）会被认为是两个符号。

参数quoteStyle用于指定引号的行为，可以是QuoteStyle.Type枚举值或数字：

• QuoteStyle.None：默认值。引号没有特殊意义。
• QuoteStyle.Csv：按照CSV的方式引用。引号是整体内容，如果引号内包含换行或回车，也属于引号内的内容。

参数includeLineSeparators用于指定结果是否包含分隔符。默认值false。

Lines.FromText("a#(lf)b#(cr)c#(cr,lf)de#(lf,cr)f#(lf)g")

Lines.FromText("a#(lf)b""b#(cr)c""#(cr,lf)de#(lf,cr)f#(lf)g", QuoteStyle.Csv)

Lines.ToBinary

Lines.ToBinary(
    lines as list, 
    optional lineSeparator as nullable text, 
    optional encoding as nullable number, 
    optional includeByteOrderMark as nullable logical
) as binary

将文本列表转为二进制值。

参数lineSeparator用于指定每个项之后添加的内容，如果不指定则添加回车和换行符。

参数encoding用于指定转为二进制所使用的编码，可以是TextEncoding.Type枚举值或数字。默认值为TextEncoding.Utf8（65001）。

参数includeByteOrderMark用于指定是否包含字节序（大小端）标记，不同类型的编码，表示字节序的内容不同。

提示

某些编码会额外添加表示字节序的内容，比如utf-8，他会在内容前添加EFBBBF。
通常，这种头只会出现在文件或字符串的开头，如果多个字符串合并到一起，应该将其去掉。

Binary.ToList(Lines.ToBinary({"a", "b", "我"}, "+", TextEncoding.Unicode, false))

Binary.ToList(Lines.ToBinary({"a", "b", "我"}, "+", TextEncoding.Utf8, true))

Lines.ToText

Lines.ToText(lines as list, optional lineSeparator as nullable text) as text

将文本列表转拼接成单个文本。行分隔符lineSeparator会被追加到每一项之后（所有项都会添加，包括最后一个项），如果未指定，则使用回车和换行符。

Lines.ToText({"a", "b", "我"})

Lines.ToText({"a", "b", "我"}, "+")