Analyser
Basic analyser interface.
Basically you want to allocate an analyser with enca_analyser_alloc() for some
language, use enca_analyse() (or enca_analyse_const()) on a buffer to find its
encoding, and interpret the results with something like enca_charset_name().
The analyser then can be used for another buffer. Once you no longer need
it, call enca_analyser_free() to release it.
A single working example is better than a hundred pages of reference manual.
A minimal Enca library application – Czech encoding
detector.
#include <stdio.h>
#include <enca.h>
int
main(void)
{
EncaAnalyser analyser;
EncaEncoding encoding;
unsigned char buffer[4096];
size_t buflen;
buflen = fread(buffer, 1, 4096, stdin);
analyser = enca_analyser_alloc("cs");
encoding = enca_analyse(analyser, buffer, buflen);
printf("Charset: %%s\n", enca_charset_name(encoding.charset,
ENCA_NAME_STYLE_HUMAN));
enca_analyser_free(analyser);
return 0;
}
The analyser has plenty of options, but generally you don't need to fiddle
with them, except enca_set_termination_strictness().
All names prefixed with ENCA_,
Enca, _Enca,
or enca_ should be treated as reserved and not used for
application function/variable/type/macro names.
@langname:
@Returns:
@analyser:
@analyser:
@buffer:
@size:
@Returns:
@analyser:
@buffer:
@size:
@Returns:
@analyser:
@Returns:
@analyser:
@errnum:
@Returns:
@analyser:
@buffer:
@size:
@Returns:
@analyser:
@Returns:
@analyser:
@multibyte:
@analyser:
@Returns:
@analyser:
@interpreted_surfaces:
@analyser:
@Returns:
@analyser:
@ambiguity:
@analyser:
@Returns:
@analyser:
@filtering:
@analyser:
@Returns:
@analyser:
@garabage_test:
@analyser:
@Returns:
@analyser:
@termination_strictness:
@analyser:
@Returns:
@analyser:
@significant:
@Returns:
@analyser:
@Returns:
@analyser:
@threshold:
@Returns:
@analyser:
@Returns: