유니코드(Unicode) 기반으로 만든 한글 관련 클래스입니다.
* * *유니코드(Unicode)는 전세계의 모든 문자를 컴퓨터에서 일관되게 표현하고 다룰 수 있도록 설계한 표준입니다. *
* *유니코드 CharacterSet에서 한글이 차지하는 영역은 세 개로 나눌 수 있습니다. * 첫번째는 0x1100-0x11F9 까지의 한글 자모 영역. 한글에서 사용되는 자모들을 초성 자음/중성 모음/종성 자음으로 각각 나누어 한글자씩 대응시킵니다. * 이 영역에 있는 글자들을 이용하면 한글 고어까지 표현이 가능해집니다. 캐릭터셋 변환이 어렵다는 단점이 있습니다. * 두번째는 0x3130-0x318E 까지의 한글 호환 자모 영역. 이 부분은 초/중/종성을 구분하지 않고 그냥 사용되는 모든 자모들이 한데 묶여 들어 있습니다. * 세번째는 0xAC00-0xD7A3 까지의 한글 영역. 이 부분에는 현대 한글 자모로 표현 가능한 모든 한글 문자들(11172자=19*21*28))이 들어 있습니다. * 간단한 계산을 통해 자모를 추출하는 것이 가능합니다. * 그 외 한자들은 다른 영역에 포함되어 있습니다.
* *입력한 문자가 한글인지 판단한다.
*(코드값이 한글 영역(0xAC00-0xD7A3)인지 판단)
* * @param c * @return 한글이면true, 아니면 false
*/
public static boolean isHangulSyllables(char ch) {
return ch >= HANGUL_SYLLABLES_BEGIN && ch <= HANGUL_SYLLABLES_END;
}
/**
* 입력한 문자가 한글 호환 자모인지 판단한다.
*(코드값이 한글 호환 자모 영역(0x1100-0x318E)인지 판단)
* * @param ch * @return 한글 호환 자모이면true, 아니면 false
*/
public static boolean isHangulCompatibilityJamo(char ch) {
return ch >= HANGUL_COMPATIBILITY_JAMO_BEGIN && ch <= HANGUL_COMPATIBILITY_JAMO_END;
}
/**
* 입력한 문자가 한글 호환 영역 중 현대 자음인지 판단한다.
*(코드값이 한글 호환 자모 영역중 현대 자음(0x3130-0x314E)인지 판단)
* * @param ch * @return */ public static boolean isHangulCompatibilityJa(char ch) { return ch >= HANGUL_COMPATIBILITY_JA_BEGIN && ch <= HANGUL_COMPATIBILITY_JA_END; } /** *입력한 문자가 한글 호환 영역중 현대 모음인지 판단한다.
*(코드값이 한글 호환 자모 영역중 현대 모음(0x314F-0x3163)인지 판단)
* * @param ch * @return */ public static boolean isHangulCompatibilityMo(char ch) { return ch >= HANGUL_COMPATIBILITY_MO_BEGIN && ch <= HANGUL_COMPATIBILITY_MO_END; } /** *입력한 문자가 한글 자모인지 판단한다.
*(코드값이 한글 자모 영역(0x3130-0x11F9)인지 판단)
* * @param ch * @return 한글 자모이면true, 아니면 false
*/
public static boolean isHangulJamo(char ch) {
return ch >= HANGUL_JAMO_BEGIN && ch <= HANGUL_JAMO_END;
}
/**
* 초성을 추출한다.
* * @param ch * @return */ public static char getChoseong(char ch) { if (isHangulSyllables(ch) == false) { throw new IllegalArgumentException("입력값이 잘못되었습니다. (" + ch + ")"); } int hCode = (ch - HANGUL_SYLLABLES_BEGIN) / (HANGUL_JUNGSEONG_SIZE * HANGUL_JONGSEONG_SIZE); return HANGUL_CHOSEONG[hCode]; } /** *중성을 추출한다.
* * @param ch * @return */ public static char getJungseong(char ch) { if (isHangulSyllables(ch) == false) { throw new IllegalArgumentException("입력값이 잘못되었습니다. (" + ch + ")"); } int hCode = ((ch - HANGUL_SYLLABLES_BEGIN) % (HANGUL_JUNGSEONG_SIZE * HANGUL_JONGSEONG_SIZE)) / HANGUL_JONGSEONG_SIZE; return HANGUL_JUNGSEONG[hCode]; } /** *종성을 추출한다.
* * @param ch * @return */ public static char getJongseong(char ch) { if (isHangulSyllables(ch) == false) { throw new IllegalArgumentException("입력값이 잘못되었습니다. (" + ch + ")"); } int hCode = ((ch - HANGUL_SYLLABLES_BEGIN) % (HANGUL_JUNGSEONG_SIZE * HANGUL_JONGSEONG_SIZE)) % HANGUL_JONGSEONG_SIZE; return HANGUL_JONGSEONG[hCode]; } /** *초/중/종성을 추출한다. *
* @param ch * @return [초성, 중성, 종성] or [초성, 중성] */ public static char[] getJamo(char ch) { char[] jamo = new char[3]; jamo[0] = getChoseong(ch); jamo[1] = getJungseong(ch); jamo[2] = getJongseong(ch); if (jamo[2] == HANGUL_JONGSEONG[0]) { char[] temp = new char[2]; temp[0] = jamo[0]; temp[1] = jamo[1]; jamo = temp; } return jamo; } /** *종성이 존재하는지 여부를 판단한다.
* * @param ch * @return 종성이 존재하면true, 아니면 false
*/
public static boolean hasJongseong(char ch) {
return getJongseong(ch) != HANGUL_JONGSEONG[0];
}
/**
* 초성, 중성을 겹합하여 한글자로 만든다.
* * @param choseong 초성 * @param jungseong 중성 * @return */ public static char toHangul(char choseong, char jungseong) { return toHangul(choseong, jungseong, HANGUL_JONGSEONG[0]); } /** *초성, 중성, 종성을 결합하여 한글자로 만든다.
* * @param choseong 초성 * @param jungseong 중성 * @param jongseong 종성 * @return */ public static char toHangul(char choseong, char jungseong, char jongseong) { Integer choseongIndex = HANGUL_CHOSEONG_CODE_TABLE.get(choseong); if (choseongIndex == null) { throw new IllegalArgumentException("초성이 잘못되었습니다. (" + choseong + ")"); } Integer jungseongIndex = HANGUL_JUNGSEONG_CODE_TABLE.get(jungseong); if (jungseongIndex == null) { throw new IllegalArgumentException("중성이 잘못되었습니다. (" + jungseong + ")"); } if (jongseong == ' ') { jongseong = HANGUL_JONGSEONG[0]; } Integer jongseongIndex = HANGUL_JONGSEONG_CODE_TABLE.get(jongseong); if (jongseongIndex == null) { throw new IllegalArgumentException("종성이 잘못되었습니다. (" + jongseong + ")"); } return (char)(HANGUL_SYLLABLES_BEGIN + (choseongIndex * (HANGUL_JUNGSEONG_SIZE * HANGUL_JONGSEONG_SIZE)) + (jungseongIndex * HANGUL_JONGSEONG_SIZE) + jongseongIndex); } /** *글자에 알맞는 조사를 선택한다.
* *
* Hangul.getJosa('한', '은', '는') = '은'
* Hangul.getJosa('지', '이', '가') = '가'
*
*
* @param ch
* @param aux1 종성이 있을때 붙일 조사
* @param aux2 종성이 없을때 붙일 조사
* @return
*/
public static char getJosa(char ch, char aux1, char aux2) {
return hasJongseong(ch) ? aux1 : aux2;
}
/**
* 글자에 알맞는 조사를 선택한다.
* *
* Hangul.getJosa('한', "은", "는") = "은"
* Hangul.getJosa('지', "이", "가") = "가"
*
*
* @param ch
* @param aux1 종성이 있을때 붙일 조사
* @param aux2 종성이 없을때 붙일 조사
* @return
*/
public static String getJosa(char ch, String aux1, String aux2) {
return hasJongseong(ch) ? aux1 : aux2;
}
}