Text.ToBinary

Syntax

Text.ToBinary(
    text as nullable text,
    optional encoding as nullable number,
    optional includeByteOrderMark as nullable logical
) as nullable binary

About

使用指定的编码将文本值编码为二进制值。

• text：要编码的文本。
• encoding：（可选） 用于将文本转换为二进制文件的编码。 使用 BinaryEncoding.Type 来指定编码类型。 如果未指定此值，则默认值为 BinaryEncoding.Utf8。
• includeByteOrderMark：（可选） 确定是否应在二进制输出的开头包含字节顺序标记（BOM）。 设置为 true 以自动包含 BOM，否则设置为 false。 如果未指定此值，则默认值为 false。

示例 1

将文本编码为二进制文件，生成可查看的 Base64 字符串，然后将其解码回文本。

用法

let
    originalText = "Testing 1-2-3",

    // Default UTF-8 binary
    binaryData = Text.ToBinary(originalText),

    // Convert binary to viewable Base64 string
    encodedText = Binary.ToText(binaryData, BinaryEncoding.Base64),

    // Decode back to text
    decodedText = Text.FromBinary(binaryData),

    result = [
        OriginalText = originalText,
        BinaryBase64 = encodedText,
        DecodedText = decodedText
    ]
in
    result

输出

[
    OriginalText = "Testing 1-2-3",
    BinaryEncoded = "VGVzdGluZyAxLTItMw==",
    DecodedText = "Testing 1-2-3"
]

示例 2

使用字节顺序标记（BOM）将文本编码为二进制文件，生成可查看的十六进制字符串，然后将其解码回文本。

用法

let
    originalText = "Testing 1-2-3",

    // Convert to binary with BOM
    binaryData = Text.ToBinary(originalText, TextEncoding.Utf16, true),

    // Show binary as hex to demonstrate presence of BOM (fffe)
    binaryAsHex = Binary.ToText(binaryData, BinaryEncoding.Hex),

    // Decode back to text
    decodedText = Text.FromBinary(binaryData, TextEncoding.Utf16),

    // Compare original text and decoded text
    isIdentical = originalText = decodedText,

    result = [
        OriginalText = originalText,
        BinaryHex = binaryAsHex,
        DecodedText = decodedText,
        IsIdentical = isIdentical
    ]
in
    result

输出

[
    OriginalText = "Testing 1-2-3", 
    DecodedText = "fffe540065007300740069006e006700200031002d0032002d003300",
    DecodedText = "Testing 1-2-3", 
    IsIdentical = true 
]