Crockford Base32 인코더 및 디코더

Crockford Base32란?

Douglas Crockford는 사람이 읽고, 입력하고, 소리 내어 말하는 식별자를 위해 이 Base32 알파벳을 설계했습니다. 숫자 10개와 대문자 22개, 즉 0123456789ABCDEFGHJKMNPQRSTVWXYZ를 사용합니다. 문자 I와 L은 숫자 1과, O는 0과 비슷해 보여서 제외했고, U는 우연히 외설적인 단어가 만들어질 가능성을 줄이기 위해 제외했습니다.

기호 하나가 5비트를 담으므로 RFC 4648 Base32와 마찬가지로 5바이트가 8문자가 됩니다. 기호는 ASCII 오름차순으로 배열되어 있어, 패딩 없이 같은 대소문자로 쓴 문자열은 인코딩된 데이터와 같은 순서로 정렬됩니다. Crockford의 사양은 패딩을 사용하지 않으므로 ‘패딩’ 옵션은 꺼 두십시오.

너그러운 디코딩

Crockford의 사양은 디코더가 사람이 실제로 입력하는 값을 받아들이도록 요구하며, 이 도구도 그렇게 동작합니다.

• 대문자와 소문자를 똑같이 취급합니다.
• 문자 O는 숫자 0으로, 문자 I와 L은 1로 읽습니다.
• 긴 코드를 읽기 쉽게 하려고 넣은 하이픈은 무시하며, 공백과 줄 바꿈도 마찬가지로 무시합니다.

문자 U는 유효하지 않으므로 위치와 함께 오류로 표시됩니다.

바이트, 숫자, ULID

Crockford는 자신의 인코딩을 숫자를 기준으로 설명하지만, 이 도구는 바이트열을 RFC 4648 방식대로 5비트 묶음으로 나누어 Crockford의 기호로 인코딩합니다. 비트 수가 5의 배수가 아닐 때 숫자 기반 구현은 남는 0 비트를 앞에 두고 이 도구는 끝에 두므로 결과가 다를 수 있습니다.

대표적인 예가 ULID입니다. ULID는 Crockford 알파벳을 쓰지만 128비트 값을 하나의 숫자로 보고 26자로 인코딩합니다. 그래서 ULID의 16바이트를 여기서 인코딩하면 같은 문자열이 나오지 않고, ULID를 디코딩하면 2비트 밀린 바이트가 나옵니다. Crockford 사양의 선택적 검사 기호, 즉 값을 37로 나눈 나머지를 나타내는 추가 문자는 지원하지 않습니다. 이 도구는 검사 기호를 추가하지도 검증하지도 않습니다.