Text.ToBinary

Syntax

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

About

Codiert einen Textwert mithilfe der angegebenen Codierung in einen Binärwert.

• text: Der zu codierenden Text.
• encoding: (Optional) Die Codierung, die zum Konvertieren des Texts in eine Binärdatei verwendet wird. Wird BinaryEncoding.Type verwendet, um den Typ der Codierung anzugeben. Wenn dieser Wert nicht angegeben ist, lautet BinaryEncoding.Utf8der Standardwert .
• includeByteOrderMark: (Optional) Bestimmt, ob am Anfang der binären Ausgabe ein Bytereihenfolgenzeichen (Byte Order Mark, BOM) enthalten sein soll. Legen Sie den Wert auf true fest, um die BOM automatisch einzuschließen, andernfalls false. Wenn dieser Wert nicht angegeben ist, lautet falseder Standardwert .

Beispiel 1

Codieren Sie Text in binär, erzeugen Sie eine sichtbare Base64-Zeichenfolge, und decodieren Sie ihn dann wieder in Text.

Verwendung

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

Output

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

Beispiel 2

Codieren Sie Text mit einer Bytereihenfolgemarke (BYTE Order Mark, BOM), erzeugen Sie eine sichtbare hexadezimale Zeichenfolge, und decodieren Sie ihn dann wieder in Text.

Verwendung

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

Output

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