KSC5601
[ class tree: KSC5601 ] [ index: KSC5601 ] [ all elements ]

Class: KSC5601

Source Location: /KSC5601/KSC5601.php

Class Overview


KSC5601 pear 패키지는 한글과 관련된 변환 및 체크에 대한 method를 제공한다.


Methods



Class Details

[line 88]
KSC5601 pear 패키지는 한글과 관련된 변환 및 체크에 대한 method를 제공한다.

UHC와 UTF8 또는 UHC와 UCS2, UHC(또는 CP949)와 NCR (Numeric character reference) 코드간의 변환을 제공하며, 또한 UHC와 NCR간의 변환은 KSX1001 범위 밖의 인식되지 못하는 문자를 출력 가능하게 한다.

그 외에 utf-8 여부 체크와 ksc5601 여부 체크가 가능하며, 다국어 처리를 위한 substr을 제공한다.




[ Top ]


Class Methods


constructor __construct [line 117]

void __construct( )

iconv 또는 mbstring 확장이 지원되면, 내부적으로 KSC5601_ext class 사용하며, 지원되지 않으면, KSC5601_pure class를 사용한다.

성능상으로는 iconv 또는 mbstring이 지원되는 것이 좋다.




Tags:

access:  public


[ Top ]

method is_hangul [line 188]

boolean is_hangul( string $s)

주어진 문장에 한글(UTF-8/EUC-KR)이 포함되어 있는지를 검사

이 method의 경우에는 한글이 아닌 다른 multibyte 문자의 마지막 바이트와 첫번째 바이트에 의한 오차가 발생할 수 있으므로 정확도가 필요할 경우에는 is_ksc5601 method를 이용해야 한다.




Tags:

since:  2.0.3
access:  public


Parameters:

string   $s  

[ Top ]

method is_ksc5601 [line 213]

boolean is_ksc5601( string $string, [boolean $ksx1001 = false])

주어진 2byte 문자가 ksc5601의 범위에 있는지 확인한다.

주의할 것은 문자열을 지정했을 경우 처음 2byte만 체크한다.




Tags:

return:  ksc5601의 범위 안에 있을 경우 true 반환
since:  version 2.0.1
access:  public


Parameters:

string   $string   2byte 문자
boolean   $ksx1001   사용하지 않음. 기본값 false

[ Top ]

method is_ksx1001 [line 255]

boolean is_ksx1001( string $string)

주어진 2byte 문자가 ksx1001의 범위에 있는지 확인한다.

주의할 것은 문자열을 지정했을 경우 처음 2byte만 체크한다.




Tags:

return:  ksx1001의 범위 안에 있을 경우 true 반환
since:  version 2.0.1
access:  public


Parameters:

string   $string   2byte 문자

[ Top ]

method is_utf8 [line 170]

boolean is_utf8( string $string, [boolean $ascii_only_check = false])

주어진 문자열이 utf8인지 아닌지를 검사한다.



Tags:

return:  utf-8 문자열 또는 ascii로만 구성이 된 문자열이이면 true를 반환한다.
access:  public


Parameters:

string   $string   검사할 문자열
boolean   $ascii_only_check   true로 설정시, 문자열이 ascii로만 구성되어 있으면 false를 반환한다.

[ Top ]

method make_reverse_table [line 476]

void make_reverse_table( void 0)

KSC5601의 역변환 테이블을 PHP code로 출력한다.

이 method는 KSC5601 pure code 개발을 위해서만 필요하다.




Tags:

access:  public


Parameters:

void   0  

[ Top ]

method ncr [line 462]

string ncr( string $string, [string $to = NCR], [boolean $enc = false])

UHC와 NCR(Numeric Code Reference)간의 변환을 제공한다.



Tags:

access:  public


Parameters:

string   $string   원본 문자열
string   $to  

(optional) 기본값 NCR. 사용할 수 있는 값으로 NCR 또는 UHC 상수를 사용할 수 있다.

NCR 상수로 설정이 되면, UHC(CP949)를 NCR 코드로 변환한다.

UHC 상수로 설정이 되면, NCR 코드를 UHC(CP949)로 변환한다.

boolean   $enc  

(optional) 기본값 false. 이 파라미터는 두번째 파라미터가 NCR일 경우에만 작동한다.

false로 설정되면, KSC5601::out_of_ksx1001(true)가 호출이 되어 내부적으로 private $out_ksx1001 변수의 값이 true로 설정이 되었을 경우, KX1001 범위 밖의 한글만 NCR로 변환한다.

true로 설정이 되면 모든 문자를 NCR 코드로 변환한다.


[ Top ]

method out_of_ksx1001 [line 154]

boolean out_of_ksx1001( [boolean $flag = false])

KSX1001 범위 밖의 한글을 변환할 것인지 여부를 설정한다. 이 menotd는 private $out_ksx1001 변수값을 변경한다.



Tags:

return:  Return
access:  public


Parameters:

boolean   $flag   (optional) 기본값 false
  1. true : UTF-8 디코드시, KSX1001 범위 밖의 한글 문자를 NCR로 변환한다.
  2. true : UHC(CP949)에서 NCR로 변환시, KSX1001 범위 밖의 한글 문자만 NCR로 변환한다.
  3. false : 아무 액션을 하지 않는다.

[ Top ]

method substr [line 280]

string|false substr( string $str, integer $start, integer $len)

지정된 시작지점에서 지정될 길이만큼의 문자열을 반환한다.

EUC-KR과 UTF-8을 모두 지원하며, UTF-8 CJK 문자열의 경우 3byte 문자는 길이를 2byte로 계산하여 반환한다. (2byte utf-8은 지원하지 않는다.)

UTF-8 문자열 처리의 경우, CJK(Chinese, Japanese, Korean) 모두 처리 가능 하며 non UTF-8의 경우 EUC-KR과 EUC-JP에 사용 가능하다.

이 외의 동작은 PHP core의 substr() 함수와 동일하게 동작한다.




Tags:

since:  버전 2.0.2
access:  public


Parameters:

string   $str   원본 문자열
integer   $start   시작 지점. 0부터 시작한다.
integer   $len   반환할 문자열 길이

[ Top ]

method ucs2 [line 432]

string ucs2( string $string, [string $to = UCS2], [boolean $asc = false])

UHC와 UCS2간의 변환을 제공한다.



Tags:

access:  public


Parameters:

string   $string   원본 문자열
string   $to  

(optional) 기본값 UCS2. 사용할 수 있는 값으로 UCS2 또는 UHC 상수를 사용할 수 있따.

UCS2 상수로 설정을 하면, UHC를 UCS2 16진수(예를 들면 U+B620)로 변환을 한다.

UHC로 설정을 하면, UC2 16진수 문자를 UHC로 변환한다.

boolean   $asc  

(optional) 기본값 false. 이 파라미터는 오직 두번째 파라미터가 UCS2일 경우에만 작동한다.

false로 설정이 되면, KSX1001 범위 밖의 한글만 UCS2 16진수 값으로 변환한다.


[ Top ]

method utf8 [line 407]

string utf8( string $string, [string $to = UTF8])

Convert between UHC and UTF-8 UHC(CP949)와 UTF-8 간의 변환을 제공한다.



Tags:

see:  KSC5601::out_of_ksx1001()
since:  version 2.0.2, 이전 버전에서는 KSC5601::out_of_ksc1001()
access:  public


Parameters:

string   $string   변환할 원본 문자열
string   $to  

(optional) 기본값 UTF8. 사용할 수 있는 값으로 UTF8 또는 UHC 상수를 사용할 수 있다.

이 인자를 설정하지 않거나 또는 UTF8 상수로 설정을 하면, 원본 문자열을 UTF-8로 변환한다.

UHC 상수로 설정하면, UTF-8에서 UHC로 변환한다. 내부적으로 KSC5601::out_of_ksx1001 (true) 코드에 의하여 private $out_ksx1001 변수가 true로 설정이 되면, KSX1001 범위 밖의 문자에 대해서는 NCR로 변환을 한다.


[ Top ]


Documentation generated on Fri, 30 Aug 2024 06:10:34 +0900 by phpDocumentor 1.4.4