이름

       detect_handledata - 문자셋과 정확도를 측정

사용법

       #include <chardet.h>

       short chardet_handledata (Detect ** handle, const char * inbuf, DetectObj ** outbuf);

설명

       inbuf 의 문자셋과 정확도를 outbuf에 저장한다.

       handle
              detect_init api에 의하여 할당된 detect handle resource.

       inbuf
              문자셋과 정확도를 측정할 입력 문자열

       outbuf
              inbuf 의 문자셋과 정확도를 구하여 저장을 한다.  outbuf 의 구조는 다음과 같다.

                   typedef struct DetectObject {
                        char * encoding;
                        float confidence;
                   } DetectObj;

              outbuf는 detect_obj_init api를 이용하여 초기화를 한 후에 detect api로 넘겨줘야 한다.

반환값

       경우에 따라 아래의 상태를 반환한다.

       CHARDET_SUCCESS
              성공

       CHARDET_NO_RESULT
              탐지하지 못했을 경우

       CHARDET_NULL_OBJECT
              outbuf 을 chardet_obj_init api를 이용하여 메모리 할당을 하지 않았을 경우.

       CHARDET_OUT_OF_MEMORY
              내부 API에서 out of memory 가 발생했을 경우

예제

       #include <chardet.h>

       int main (void) {
            Detect    * d;
            DetectObj * obj;
            int i, arrayNum;
            char *str[] = {
                 "this is ascii",
                 "이건 euc-kr 입니다."
            };

            arrayNum = sizeof (str) / sizeof (str[0]);

            if ( (d = detect_init ()) == NULL ) {
                 fprintf (stderr, "chardet handle initialize failed\n");
                 return CHARDET_MEM_ALLOCATED_FAIL;
            }

            for ( i=0; i<arrayNum; i++ ) {
                 detect_reset (&d);

                 if ( (obj = detect_obj_init ()) == NULL ) {
                      fprintf (stderr, "Memory Allocation failed\n");
                      return CHARDET_MEM_ALLOCATED_FAIL;
                 }

                 switch (detect_handledata (&d, "안녕하세요", &obj)) {
                      case CHARDET_OUT_OF_MEMORY :
                           fprintf (stderr, "On handle processing, occured out of memory\n");
                           detect_obj_free (&obj);
                           return CHARDET_OUT_OF_MEMORY;
                      case CHARDET_NULL_OBJECT :
                           fprintf (stderr,
                                     "2st argument of chardet() is must memory allocation "
                                     "with detect_obj_init API\n");
                           return CHARDET_NULL_OBJECT;
                 }

                 printf ("encoding: %s, confidence: %f\n", obj->encoding, obj->confidence);
                 detect_obj_free (&obj);
            }
            detect_destroy (&d);

           return 0;
       }

저자

       김정균

버그 리포트

       <http://oops.org> 의 QnA 게시판을 이용한다.

참고

       detect_obj_init(3), detect_obj_free(3), detect_init(3), detect_reset(3), detect_destroy(3)

libchardet manuals                                 2011-05-02                               detect_handledata(3)