blc_hangul_normalize.h

blc_hangul_normalize.h 에는 한글 정규화 및 비슷한 기능을 갖는 전역 함수들이 선언되어 있습니다. blc_hangul.h 처럼 현대 한글에만 적용할 수 있습니다.

아래 함수들에 사용되는 JamoTable 클래스에 관한 자세한 내용은 blc_hangul.h 헤더의 설명 문서에서 찾을 수 있습니다.

이 문서에서는 blc_hangul_normalize.h 에 포함된 전역 함수들에 대해 설명합니다. 아래에 설명된 전역 함수들은 모두 namespace blc::han 내부에 선언되어 있습니다.

전역 함수

std::u8string NFC(
const std::u8string& str,
const JamoTable& table,
const ustr::CheckCharFuncType& check_char = ustr::CheckCharFuncType()
)
문자열 str의 문자들 중 (호환용) 한글 자모 낱자들이 있는 경우 가능하면 자모 낱자들을 결합하여 한글 음절 문자로 만듭니다. 문자열 str은 DefaultEncoding(UTF-8)로 인코딩 되어 있어야 합니다(2022/11/18 버전부터 매개변수와 반환 타입이 std::string에서 std::u8string으로 변경되었습니다). JamoTable 타입의 "한글 자모 테이블"을 넘겨 주면, 한글 자모 낱자에 대해 유니코드 정규화의 NFC로의 정규화(정준 결합)를 수행합니다. JamoTable 타입의 "호환용 한글 자모 테이블"을 넘겨 주면, 호환용 한글 자모 낱자에 대해 유니코드 정규화의 NFC로의 정규화(정준 결합) 비슷한 작업을 수행합니다. check_char을 통해 올바르지 않은 DefaultEncoding(UTF-8) 문자를 처리하는 함수를 지정할 수 있습니다. CheckCharFuncType에 대한 자세한 설명은 아래의 참고자료에서 볼 수 있습니다.
참고자료
std::u8string NFD(
const std::u8string& str,
const JamoTable& table,
const ustr::CheckCharFuncType& check_char = ustr::CheckCharFuncType()
)
문자열 str의 문자들 중 한글 음절 문자들이 있는 경우 음절 문자들을 (호환용) 한글 자모 낱자로 분해합니다. 문자열 str은 DefaultEncoding(UTF-8)로 인코딩 되어 있어야 합니다(2022/11/18 버전부터 매개변수와 반환 타입이 std::string에서 std::u8string으로 변경되었습니다). JamoTable 타입의 "한글 자모 테이블"을 넘겨 주면, 한글 자모 낱자에 대해 유니코드 정규화의 NFD로의 정규화(정준 분해)를 수행합니다. JamoTable 타입의 "호환용 한글 자모 테이블"을 넘겨 주면, 호환용 한글 자모 낱자에 대해 유니코드 정규화의 NFD로의 정규화(정준 분해) 비슷한 작업을 수행합니다. check_char을 통해 올바르지 않은 DefaultEncoding(UTF-8) 문자를 처리하는 함수를 지정할 수 있습니다. CheckCharFuncType에 대한 자세한 설명은 아래의 참고자료에서 볼 수 있습니다.
참고자료
std::u8string NFC_kblv(
const std::u8string& str,
const JamoTable& table,
const ustr::CheckCharFuncType& check_char = ustr::CheckCharFuncType()
)
NFC 함수와 비슷한 작업을 하지만, 키보드 입력 수준의 결합을 수행합니다. 예를 들어 "ㅅㅏㄹㄱ" 을 NFC 함수로 결합한 결과는 "살ㄱ" 이 되지만, NFC_kblv 함수로 결합한 결과는 "삵"이 됩니다. 문자열 str은 DefaultEncoding(UTF-8)로 인코딩 되어 있어야 합니다(2022/11/18 버전부터 매개변수와 반환 타입이 std::string에서 std::u8string으로 변경되었습니다). NFC 함수와 마찬가지로 JamoTable 타입의 객체 "한글 자모 테이블"을 넘겨주면, 한글 자모 낱자에 대해 작업을 수행하며, JamoTable 타입의 객체 "호환용 한글 자모 테이블"을 넘겨주면, 호환용 한글 자모 낱자에 대해 작업을 수행합니다. check_char을 통해 올바르지 않은 DefaultEncoding(UTF-8) 문자를 처리하는 함수를 지정할 수 있습니다. CheckCharFuncType에 대한 자세한 설명은 아래의 참고자료에서 볼 수 있습니다.
참고자료
std::u8string NFD_kblv(
const std::u8string& str,
const JamoTable& table,
const ustr::CheckCharFuncType& check_char = ustr::CheckCharFuncType()
)
NFD 함수와 비슷한 작업을 하지만, 키보드 입력 수준의 분해를 수행합니다. 예를 들어 "삵"을 NFD 함수로 분해한 결과는 "ㅅㅏㄺ" 이 되지만, NFD_kblv 함수로 분해한 결과는 "ㅅㅏㄹㄱ"이 됩니다. 문자열 str은 DefaultEncoding(UTF-8)로 인코딩 되어 있어야 합니다(2022/11/18 버전부터 매개변수와 반환 타입이 std::string에서 std::u8string으로 변경되었습니다). NFD 함수와 마찬가지로 JamoTable 타입의 객체 "한글 자모 테이블"을 넘겨주면, 한글 자모 낱자에 대해 작업을 수행하며, JamoTable 타입의 객체 "호환용 한글 자모 테이블"을 넘겨주면, 호환용 한글 자모 낱자에 대해 작업을 수행합니다. check_char을 통해 올바르지 않은 DefaultEncoding(UTF-8) 문자를 처리하는 함수를 지정할 수 있습니다. CheckCharFuncType에 대한 자세한 설명은 아래의 참고자료에서 볼 수 있습니다.
참고자료

blc/han/blc_hangul_normalize.h - C++ 한글 라이브러리

[2022/11/18 및 이후 버전]