BLC 사용 예제 - BLC에 인코딩 추가하기

#pragma once
#ifndef BLC_CP949_TABLE_H
#define BLC_CP949_TABLE_H
#include "blc_encoding_defines.h"
namespace blc {
namespace ustr {
namespace encoding {
class CP949Table; // 코드 테이블 클래스에 대한 전방 선언을 합니다.
// 코드 테이블에 대해 아래와 같이 IsCodeTableType의 특수화를 해 줍니다.
// 이 특수화를 통해 등록해야만 코드 테이블 클래스를 사용할 수 있습니다.
template <>
struct IsCodeTableType<CP949Table> final : public std::true_type {};
// 코드 테이블 클래스의 정의를 작성합니다. 코드 테이블 클래스가 반드시
// 포함해야 하는 요소는 다음과 같습니다. 이 멤버들만 public으로 제공한다면
// 나머지 요소는 어떻게 구현하든 상관이 없습니다.
class CP949Table final
{
public:
// 만약 추가하려는 문자 코드 페이지에 BOM(Byte Order Mark) 역할을 하는
// 문자가 존재한다면 kBom_에 그 문자 코드를 담습니다.
// kBom_은 반드시 static constexpr 속성을 갖는 uint32_t 타입
// 상수이어야 합니다. CP949처럼 그러한 역할을 하는 문자가 없다면 kBom_에
// kInvalidCharacter를 ("blc_encoding_defines.h" 헤더에 선언됨) 담습니다.
// 유니코드의 경우에는 U+FEFF 를 사용합니다.
static constexpr uint32_t kBom_ = kInvalidCharacter;
// 추가하려는 코드 페이지의 특정 문자 코드를 매개변수로 받아
// 같은 문자의 유니코드로 변환하여 반환하는 함수입니다.
// 매개변수의 타입과 반환 타입은 uint32_t 이고 상수 함수이어야 합니다.
uint32_t CodeToUnicode(uint32_t code) const {
// 여기에 실제 변환 코드를 넣습니다. 구현은 어떻게 하든 자유지만,
// 변환이 불가능한 경우에는 kInvalidCharacter를 반환해야 합니다.
}
// 특정 문자의 유니코드를 받아, 추가하려는 코드 페이지의 코드로
// 변환하여 반환하는 함수입니다. 매개변수와 반환 타입은 uint32_t 이고
// 상수 함수이어야 합니다.
uint32_t UnicodeToCode(uint32_t unicode) const {
// 마찬가지로 구현 방식은 자유지만, 변환이 불가능한 경우에는
// kInvalidCharacter를 반환해야 합니다.
}
// 매개변수 code로 넘겨받은 문자 코드가 추가하려는 코드 페이지에
// 존재하지 않는 코드라면 false, 그렇지 않으면 true를 반환하는
// 함수입니다. 이 함수도 상수 함수이어야 합니다.
// 예제에서는 CP949 코드면 true 아니면 false를
// 반환하게 되어 있습니다.
bool IsValidCode(uint32_t code) const {
// 역시 구현 방식은 자유입니다.
}
}; // class CP949Table
} // namespace encoding
} // namespace ustr
} // namespace blc
#endif // BLC_CP949_TABLE_H

"blc_cp949_table.h" 예제 코드 접기

#pragma once
#ifndef BLC_CP949_T_H
#define BLC_CP949_T_H
#include "blc_encoding_defines.h"
#include "blc_cp949_table.h"
#include "blc_encoding.h"
namespace blc {
namespace ustr {
namespace encoding {
// 인코딩/디코딩 담당 클래스를 전방 선언합니다.
template <typename T_, typename V_>
struct CP949Type;
// 인코딩/디코딩 담당 클래스에 대해 아래와 같이 IsEncodingImplType의
// 특수화를 해 줍니다.
// 이 특수화를 통해 등록해야만 인코딩/디코딩 담당 클래스를 사용할 수 있습니다.
template <typename T_, typename V_>
struct IsEncodingImplType<CP949Type<T_, V_>> final : public std::true_type {};
// 인코딩/디코딩 담당 클래스의 정의를 작성합니다. 이 클래스가 반드시
// 포함해야 하는 요소는 다음과 같습니다. 이 멤버들만 public으로 제공한다면
// 나머지 요소는 어떻게 구현하든 상관이 없습니다.
template <typename TableType_, typename = std::enable_if_t<IsCodeTableType<std::decay_t<TableType_>>::value>>
struct CP949Type final
{
// 템플릿 타입인수 TableType_에 대해 using 선언을 해줍니다.
using TableType = TableType_;
// 이 클래스가 처리할 인코딩으로 인코딩한, 문자가 차지하는
// 최대 바이트 수 + 1을 kArySize에 담습니다.
// 예를 들어 CP949는 문자 하나가 최대 2바이트로
// 인코딩 되므로, 3의 값을 담습니다. UTF-8의 경우 문자 하나가
// 최대 4바이트로 인코딩 되므로, 5의 값을 담아야 됩니다.
// kArySize는 반드시 static constexpr 속성을 갖는 SizeType 타입
// 상수이어야 합니다.
static constexpr SizeType kArySize = 3;
// 이 클래스가 처리할 인코딩으로 인코딩된,
// 멀티바이트 문자를 가리키는 포인터 ch와,
// 해당 문자가 인코딩된 바이트 수 size를 받아,
// 이 인코딩이 사용하는 코드 페이지의 문자 코드를 구해
// 반환합니다. 매개변수 타입과 반환 타입은 아래의 함수와
// 같아야 하며, 이 함수는 반드시 const noexcept 속성이어야
// 합니다.
uint32_t GetCode(const CharType* ch, SizeType size) const noexcept {
// 이곳에 실제 구현 코드를 작성합니다. 구현 방식은 자유지만,
// ch가 가리키는 멀티바이트 문자가, 이 클래스가 처리할 인코딩으로
// 인코딩 되어 있지 않은 경우 kInvalidCharacter를
// ("blc_encoding_defines.h" 헤더에 선언됨) 반환해야 합니다.
}
// 이 클래스가 처리할 인코딩이 사용하는, 코드 페이지의 문자 코드 code와,
// 이 문자 코드의 문자를 인코딩 했을 때 차지하는 바이트 수 size를 받아,
// ch가 가리키는 공간에 문자 코드 code를 인코딩하여 넣습니다.
// 매개변수 타입과 반환 타입은 아래의 함수와 같아야 하며, 이 함수는
// 반드시 const noexcept 속성이어야 합니다.
void SetCode(CharType* ch, uint32_t code, SizeType size) const noexcept {
// 이곳에 실제 구현 코드를 작성합니다. 구현 방식은 자유지만,
// size가 올바르지 않은 값(예를 들어 UTF-8 인코딩인데 size가
// 5 이상이라거나)인 경우 ch[0]에 널 문자('\0')를 담습니다.
}
// 이 클래스가 처리할 인코딩으로 인코딩된, 멀티바이트 문자를 가리키는
// str 포인터를 받아, str이 가리키는 문자 하나가 몇 바이트로
// 인코딩 되었는지 계산하여 반환하는 합수입니다.
// 매개변수 타입과 반환 타입은 아래의 함수와 같아야 하며,
// 이 함수는 반드시 const noexcept 속성이어야 합니다.
SizeType GetValidSize(const CharType* str) const noexcept {
// 이곳에 실제 구현 코드를 작성합니다. 구현 방식은 자유입니다.
}
// 이 클래스가 처리할 인코딩이 사용하는, 문자 코드 페이지의
// 문자 코드를 인수로 받아 해당 문자를 인코딩한 결과가 차지하는
// 바이트 수를 구해 반환합니다.
// 매개변수 타입과 반환 타입은 아래의 함수와 같아야 하며,
// 이 함수는 반드시 const noexcept 속성이어야 합니다.
SizeType GetValidSize(uint32_t code) const noexcept {
// 이곳에 실제 구현 코드를 작성합니다. 구현 방식은 자유입니다.
}
// UTF-8과 같이 비정상적으로 긴 바이트로 인코딩이 가능한 인코딩의 경우
// (예를 들어 0x00 ~ 0x7F 범위의 문자를 2, 3, 또는 4바이트로 인코딩 한다던지)
// 문자 코드 code가 size 바이트로 인코딩 해야하는지 점검하여,
// size가 올바른 길이인 경우 true를, 그렇지 않으면 false를 반환하는
// 함수입니다.
// UTF-8과 같이, 비정상적으로 긴 바이트로 인코딩이 가능한 경우가 아니라면
// 항상 true를 반환하도록 작성하면 됩니다.
// 이 함수 역시 반환 타입과 매개변수 타입은 아래와 같아야 하며,
// const noexcept 속성이어야 합니다.
bool CheckSize(uint32_t code, SizeType size) const noexcept {
return true; // 점검하지 않는 경우 무조건 true 반환(CP949의 경우)
}
}; // struct CP949Type
// 사용하기 편하게 아래와 같이 using 선언을 해 줍니다.
using CP949 = BasicEncodingType<CP949Type<CP949Table>>;
} // namespace encoding
} // namespace ustr
} // namespace blc
#endif // BLC_CP949_T_H

"blc_cp949_t.h" 예제 코드 접기