detect_handledata(3)

이름
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)