Text.ToBinary

Sintaksis

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

Tentang

Mengodekan nilai teks ke dalam nilai biner menggunakan pengodean yang ditentukan.

• text: Teks yang akan dikodekan.
• encoding: (Opsional) Pengodean yang digunakan untuk mengonversi teks menjadi biner. Gunakan BinaryEncoding.Type untuk menentukan jenis pengodean. Jika nilai ini tidak ditentukan, nilai defaultnya adalah BinaryEncoding.Utf8.
• includeByteOrderMark: (Opsional) Menentukan apakah Tanda Urutan Byte (BOM) harus disertakan di awal output biner. Atur ke true untuk secara otomatis menyertakan BOM, jika tidak false. Jika nilai ini tidak ditentukan, nilai defaultnya adalah false.

Contoh 1

Mengodekan teks ke biner, menghasilkan string Base64 yang dapat dilihat, lalu mendekodenya kembali ke teks.

Penggunaan

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

Hasil

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

Contoh 2

Mengodekan teks ke biner dengan Tanda Urutan Byte (BOM), menghasilkan string heksadesimal yang dapat dilihat, lalu mendekodenya kembali ke teks.

Penggunaan

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

Hasil

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