Man page - detect(3)

Packages contains this manual

Package:  libchardet-dev
apt-get install libchardet-dev

Manuals in package:
• detect_init(3)
• detect_handledata(3)
• detect_obj_free(3)
• detect_destroy(3)
• detect_obj_init(3)
• detect_reset(3)
• detect(3)
Documentations in package:
• libchardet-dev

Available languages:

en ko

Manual

detect

NAME
SYNOPSIS
DESCRIPTION
Arguments:
RETURN VALUE
EXAMPLE
AUTHORS
BUG REPORTS
SEE ALSO

---

NAME

detect, detect_r - Detecting character set and measuring accuracy of charset

SYNOPSIS

#include <chardet.h>

short detect (char * inbuf, DetectObj ** outbuf);

short detect_r (char * inbuf, size_t inlen, DetectObj ** outbuf);

DESCRIPTION

Storing charset and accuracy of inbuf to outbuf

The detect API is deprecated becase this api is not binary safe. Use or replace to detect_r api.

Arguments:

inbuf

input string for detecting

inlen

length of input string for detecting

outbuf

Storing inforamtion of inbuf. The structure of outbuf is follows.

typedef struct DetectObject {

			char * encoding;
			float confidence;
			} DetectObj;

The outbuf variable must be initialized by detect_obj_init API before calling this detect api.

RETURN VALUE

Returns following condition as case by case.
CHARDET_SUCCESS

Detecting success

CHARDET_NO_RESULT

Detection failure

CHARDET_NULL_OBJECT

Don’t initializing outbuf with chardet_obj_init

CHARDET_OUT_OF_MEMORY

Occurring out of memory at internal API

EXAMPLE

#include <chardet.h>

int main (void) {

		DetectObj *obj;
		char * checkstr = "안 녕 하 세 요 ";
		if ( (obj = detect_obj_init ()) == NULL ) {
			fprintf (stderr, "Memory Allocation failed\n");
			return CHARDET_MEM_ALLOCATED_FAIL;
		}
		//switch (detect (checkstr, &obj))
		switch (detect_r (checkstr, strlen (checkstr), &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;
		}
		# check support obj->bom with CHARDET_BOM_CHECK constant
		printf ("encoding: %s, confidence: %f, exists bom: %d\n", obj->encoding, obj->confidence, obj->bom);
		detect_obj_free (&obj);

return 0;
}

AUTHORS

JoungKyun.Kim <http://oops.org>

BUG REPORTS

Use QnA board on https://github.com/Joungkyun/libchardet/issues

SEE ALSO

detect_handledata(3), detect_obj_init(3), detect_obj_free(3)

---