본문으로 건너뛰기

Text.ToBinary

텍스트를 이진 형식으로 인코딩합니다.

Syntax

Text.ToBinary(
text as text,
optional encoding as TextEncoding.Type,
optional includeByteOrderMark as logical
) as binary

Remarks

지정된 인코딩을 사용하여 텍스트 값을 이진 값으로 인코딩합니다.

  • text: 인코딩할 텍스트입니다.
  • encoding: (선택 사항) 텍스트를 이진으로 변환하는 데 사용되는 인코딩입니다. BinaryEncoding.Type을 사용하여 인코딩 유형을 지정합니다. 이 값을 지정하지 않으면 기본값은 BinaryEncoding.Utf8입니다.
  • includeByteOrderMark: (선택 사항) 이진 출력의 시작 부분에 BOM(바이트 순서 표시)을 포함해야 하는지 여부를 결정합니다. BOM을 자동으로 포함하려면 true로 설정하고, 그렇지 않으면 false로 설정합니다. 이 값을 지정하지 않으면 기본값은 false입니다.

Examples

Example #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

Result:

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

Example #2

BOM(바이트 순서 표시)을 사용하여 텍스트를 이진으로 인코딩하고, 볼 수 있는 16진수 문자열을 생성한 다음, 텍스트로 다시 디코딩합니다.

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

Result:

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

Category

Text.Conversions from and to text