Swift & Objective-C

Swift 문자열 길이: 한글·이모지·바이트를 직접 비교하기

String.count와 Unicode scalar, UTF-16, UTF-8 길이는 서로 다른 단위를 셉니다. 완성형·조합형 한글과 가족 이모지를 실행해 값 비교, 딕셔너리 조회, 안전한 앞부분 자르기를 확인합니다.

3분 읽기
Swift 문자열 길이: 한글·이모지·바이트를 직접 비교하기 대표 이미지

문자열 길이 제한을 구현하기 전에 무엇을 셀지 정해야 합니다. Swift의 count는 Character, 즉 확장 그래핌 클러스터를 세지만 전송 크기 제한은 보통 바이트 단위입니다. 같은 화면 글자라도 내부 표현의 크기는 다를 수 있습니다.

핵심 원리와 선택 기준

실험의 한글 음절은 완성형 한 개 또는 조합 자모 세 개로 표현됩니다. Swift String은 정규 동등성을 고려하므로 두 표현을 같다고 비교하고 딕셔너리 키로도 같은 값에 접근합니다. 가족 이모지는 여러 스칼라가 하나의 Character를 이루는 예입니다. 다른 언어의 길이 API가 다른 단위를 센다는 사실 자체가 오류는 아닙니다. 공식 근거

재현 코드

Unicode escape로 정확한 입력을 고정하고, 한글 두 표현의 count·스칼라 수·UTF-8 바이트 수를 비교합니다. 가족 이모지의 UTF-16과 UTF-8 길이를 확인하고, A와 B 사이에 넣은 문자열에서 prefix와 String.Index를 사용합니다. 빈 문자열 접근도 별도로 검사합니다.

아래 코드는 2026-10-23에 Apple Swift 6.4, arm64 macOS 대상에서 Swift 6 언어 모드로 실행했습니다. 네트워크나 별도 패키지가 필요 없는 독립 실습입니다.

전체 Swift 파일 내려받기

파일을 내려받은 폴더에서 실행하세요. 출력은 검증 결과이며, 실행 중 조건이 어긋나면 precondition에서 중단됩니다. -Ounchecked 옵션은 검증을 제거하므로 사용하지 마세요.

swift -swift-version 6 swift-string-grapheme-cluster-indexing.swift
let composed = "\u{D55C}"
let decomposed = "\u{1112}\u{1161}\u{11AB}"
precondition(composed == decomposed)
precondition(composed.count == 1 && decomposed.count == 1)
precondition(composed.utf8.count == 3 && decomposed.utf8.count == 9)
precondition(decomposed.unicodeScalars.count == 3)
let lookup = [composed: 42]
precondition(lookup[decomposed] == 42)

let family = "\u{1F468}\u{200D}\u{1F469}\u{200D}\u{1F467}\u{200D}\u{1F466}"
precondition(family.count == 1 && family.unicodeScalars.count == 7)
precondition(family.utf16.count == 11 && family.utf8.count == 25)
let text = "A" + family + "B"
precondition(text.count == 3 && String(text.prefix(2)) == "A" + family)
let second = text.index(after: text.startIndex)
precondition(String(text[second]) == family)
let empty = ""
precondition(empty.first == nil && empty.prefix(2).isEmpty)
print("hangul=characters:1,scalars:1/3,utf8:3/9 equal:true dictionary:42")
print("family=characters:1,scalars:7,utf16:11,utf8:25 prefix=2 empty=safe")

실행 결과와 해석

hangul=characters:1,scalars:1/3,utf8:3/9 equal:true dictionary:42
family=characters:1,scalars:7,utf16:11,utf8:25 prefix=2 empty=safe

한글 두 표현은 각각 Character 1개지만 UTF-8은 3바이트와 9바이트이며, 조합형은 스칼라 3개입니다. 같은 딕셔너리 키로 조회한 값은 42였습니다. 가족 이모지는 Character 1개·스칼라 7개·UTF-16 11개·UTF-8 25바이트였습니다. prefix(2)는 이모지 중간을 자르지 않았습니다.

적용 범위와 주의점

Character가 모든 언어에서 사람이 인식하는 한 글자와 완벽히 같다는 뜻은 아닙니다. 분할 규칙과 Unicode 버전도 고려해야 합니다. 바이트 제한은 조합형 한글이나 이모지에 ‘글자당 3바이트’ 공식을 적용할 수 없습니다. Swift Dictionary를 위해 항상 NFC 정규화가 필요한 것은 아니지만 외부 시스템의 비교·인코딩 계약은 별도로 확인해야 합니다.

다음으로 확인할 것

서버와 클라이언트가 글자 수인지 UTF-8 바이트인지 먼저 합의하세요. 미리보기는 prefix처럼 Character 단위 API를 쓰고, 무작위 문자 접근이 반복되면 배열 변환 비용과 추가 메모리를 비교합니다. 입력 부재와 빈 문자열의 차이는 Optional 실습으로 이어집니다.

연결해서 읽기

출처 및 확인 기준