Main Page | Compound List | File List | Compound Members | File Members

librcc.h File Reference

#include <stdlib.h>

Go to the source code of this file.

Compounds

struct  rcc_class_default_charset_t
struct  rcc_class_t
struct  rcc_compiled_configuration_t
struct  rcc_engine_t
struct  rcc_language_alias_t
struct  rcc_language_t
struct  rcc_option_range_t

Defines

#define RCC_MAX_CHARSETS   16
#define RCC_MAX_ENGINES   5
#define RCC_MAX_LANGUAGES   64
#define RCC_MAX_ALIASES   64
#define RCC_MAX_CLASSES   16
#define RCC_MAX_ERRORS   3
#define RCC_MAX_CHARSET_CHARS   16
#define RCC_MAX_LANGUAGE_CHARS   16
#define RCC_MAX_VARIABLE_CHARS   16
#define RCC_FLAG_NO_DEFAULT_CONFIGURATION   1
#define RCC_CLASS_FLAG_CONST   0x01
#define RCC_CLASS_FLAG_SKIP_SAVELOAD   0x02
#define RCC_OPTION_LEARNING_FLAG_USE   1
#define RCC_OPTION_LEARNING_FLAG_LEARN   2
#define rccFrom(ctx, class_id, buf)   rccSizedFrom(ctx, class_id, buf, 0)
#define rccTo(ctx, class_id, buf)   rccSizedTo(ctx, class_id, buf, NULL)
#define rccRecode(ctx, from, to, buf)   rccSizedRecode(ctx, from, to, buf, 0, NULL)
#define rccFromCharset(ctx, charset, buf)   rccSizedFromCharset(ctx, charset, buf, 0)
#define rccToCharset(ctx, charset, buf)   rccSizedToCharset(ctx, charset, buf, NULL)
#define rccRecodeToCharset(ctx, class_id, charset, buf)   rccSizedRecodeToCharset(ctx, class_id, charset, buf, 0, NULL)
#define rccRecodeFromCharset(ctx, class_id, charset, buf)   rccSizedRecodeFromCharset(ctx, class_id, charset, buf, 0, NULL)
#define rccRecodeCharsets(ctx, from, to, buf)   rccSizedRecodeCharsets(ctx, from, to, buf, 0, NULL)
#define RCC_CC_FLAG_HAVE_BERKLEY_DB   0x01
#define RCC_CC_FLAG_HAVE_DYNAMIC_ENGINES   0x02
#define RCC_CC_FLAG_HAVE_ENCA   0x04
#define RCC_CC_FLAG_HAVE_RCD   0x08

Typedefs

typedef unsigned char rcc_language_id
typedef unsigned char rcc_alias_id
typedef unsigned char rcc_charset_id
typedef unsigned char rcc_autocharset_id
typedef unsigned char rcc_engine_id
typedef int rcc_class_id
typedef rcc_context_t * rcc_context
typedef rcc_engine_context_t * rcc_engine_context
typedef rcc_language_config_t * rcc_language_config
typedef const struct rcc_class_trcc_class_ptr
typedef unsigned int rcc_init_flags
typedef unsigned int rcc_db4_flags
typedef const char * rcc_charset
typedef rcc_charset rcc_charset_list [RCC_MAX_CHARSETS+1]
typedef void * rcc_engine_internal
typedef rcc_engine_internal(* rcc_engine_init_function )(rcc_engine_context ctx)
typedef rcc_autocharset_id(* rcc_engine_function )(rcc_engine_context ctx, const char *buf, int len)
typedef void(* rcc_engine_free_function )(rcc_engine_context ctx)
typedef rcc_engine_t rcc_engine
typedef rcc_enginercc_engine_ptr
typedef rcc_engine_ptr rcc_engine_list [RCC_MAX_ENGINES+1]
typedef rcc_language_t rcc_language
typedef rcc_languagercc_language_ptr
typedef rcc_language_ptr rcc_language_list [RCC_MAX_LANGUAGES+1]
typedef rcc_language_alias_t rcc_language_alias
typedef rcc_language_aliasrcc_language_alias_ptr
typedef rcc_language_alias_ptr rcc_language_alias_list [RCC_MAX_ALIASES+1]
typedef enum rcc_class_type_t rcc_class_type
typedef const struct rcc_class_default_charset_t rcc_class_default_charset
typedef const struct rcc_class_t rcc_class
typedef rcc_class_ptr rcc_class_list [RCC_MAX_CLASSES+1]
typedef int rcc_option_value
typedef enum rcc_option_t rcc_option
typedef enum rcc_option_type_t rcc_option_type
typedef enum rcc_option_range_type_t rcc_option_range_type
typedef rcc_option_range_t rcc_option_range
typedef char * rcc_string
typedef const char * rcc_const_string
typedef rcc_iconv_t * rcc_iconv
typedef void * rcc_config
typedef rcc_engine *(* rcc_plugin_engine_info_function )(const char *lang)
typedef rcc_compiled_configuration_t rcc_compiled_configuration_s
typedef const struct rcc_compiled_configuration_trcc_compiled_configuration

Enumerations

enum  rcc_class_type_t { RCC_CLASS_INVALID = 0, RCC_CLASS_STANDARD, RCC_CLASS_KNOWN, RCC_CLASS_FS }
enum  rcc_option_t {
  RCC_OPTION_LEARNING_MODE = 0, RCC_OPTION_AUTODETECT_FS_TITLES, RCC_OPTION_AUTODETECT_FS_NAMES, RCC_OPTION_CONFIGURED_LANGUAGES_ONLY,
  RCC_MAX_OPTIONS
}
enum  rcc_option_type_t { RCC_OPTION_TYPE_INVISIBLE = 0, RCC_OPTION_TYPE_STANDARD, RCC_OPTION_TYPE_MAX }
enum  rcc_option_range_type_t {
  RCC_OPTION_RANGE_TYPE_BOOLEAN = 0, RCC_OPTION_RANGE_TYPE_RANGE, RCC_OPTION_RANGE_TYPE_FLAGS, RCC_OPTION_RANGE_TYPE_MENU,
  RCC_OPTION_RANGE_TYPE_MAX
}

Functions

int rccInit ()
void rccFree ()
rcc_context rccCreateContext (const char *locale_variable, unsigned int max_languages, unsigned int max_classes, rcc_class_ptr defclasses, rcc_init_flags flags)
int rccInitDefaultContext (const char *locale_variable, unsigned int max_languages, unsigned int max_classes, rcc_class_ptr defclasses, rcc_init_flags flags)
void rccFreeContext (rcc_context ctx)
int rccInitDb4 (rcc_context ctx, const char *name, rcc_db4_flags flags)
int rccLockConfiguration (rcc_context ctx, unsigned int lock_code)
int rccUnlockConfiguration (rcc_context ctx, unsigned int lock_code)
rcc_language_id rccRegisterLanguage (rcc_context ctx, rcc_language *language)
rcc_charset_id rccLanguageRegisterCharset (rcc_language *language, rcc_charset charset)
rcc_engine_id rccLanguageRegisterEngine (rcc_language *language, rcc_engine *engine)
rcc_alias_id rccRegisterLanguageAlias (rcc_context ctx, rcc_language_alias *alias)
rcc_class_id rccRegisterClass (rcc_context ctx, rcc_class *cl)
rcc_class_type rccGetClassType (rcc_context ctx, rcc_class_id class_id)
const char * rccGetLanguageName (rcc_context ctx, rcc_language_id language_id)
rcc_language_id rccGetLanguageByName (rcc_context ctx, const char *name)
rcc_language_id rccGetRealLanguage (rcc_context ctx, rcc_language_id language_id)
const char * rccGetRealLanguageName (rcc_context ctx, rcc_language_id language_id)
rcc_language_id rccGetSelectedLanguage (rcc_context ctx)
const char * rccGetSelectedLanguageName (rcc_context ctx)
rcc_language_id rccGetCurrentLanguage (rcc_context ctx)
const char * rccGetCurrentLanguageName (rcc_context ctx)
int rccSetLanguage (rcc_context ctx, rcc_language_id language_id)
int rccSetLanguageByName (rcc_context ctx, const char *name)
rcc_option_value rccGetOption (rcc_context ctx, rcc_option option)
int rccOptionIsDefault (rcc_context ctx, rcc_option option)
int rccOptionSetDefault (rcc_context ctx, rcc_option option)
int rccSetOption (rcc_context ctx, rcc_option option, rcc_option_value value)
rcc_option_type rccOptionGetType (rcc_context ctx, rcc_option option)
rcc_option_rangerccOptionGetRange (rcc_context ctx, rcc_option option)
const char * rccGetOptionName (rcc_option option)
const char * rccGetOptionValueName (rcc_option option, rcc_option_value value)
rcc_option rccGetOptionByName (const char *name)
rcc_option_value rccGetOptionValueByName (rcc_option option, const char *name)
rcc_language_config rccCheckConfig (rcc_context ctx, rcc_language_id language_id)
rcc_language_config rccGetConfig (rcc_context ctx, rcc_language_id language_id)
rcc_language_config rccGetConfigByName (rcc_context ctx, const char *name)
rcc_language_config rccGetCurrentConfig (rcc_context ctx)
const char * rccConfigGetEngineName (rcc_language_config config, rcc_engine_id engine_id)
const char * rccConfigGetCharsetName (rcc_language_config config, rcc_charset_id charset_id)
rcc_engine_id rccConfigGetEngineByName (rcc_language_config config, const char *name)
rcc_charset_id rccConfigGetCharsetByName (rcc_language_config config, const char *name)
rcc_engine_id rccConfigGetSelectedEngine (rcc_language_config config)
const char * rccConfigGetSelectedEngineName (rcc_language_config config)
rcc_engine_id rccConfigGetCurrentEngine (rcc_language_config config)
const char * rccConfigGetCurrentEngineName (rcc_language_config config)
rcc_charset_id rccConfigGetSelectedCharset (rcc_language_config config, rcc_class_id class_id)
const char * rccConfigGetSelectedCharsetName (rcc_language_config config, rcc_class_id class_id)
rcc_charset_id rccConfigGetCurrentCharset (rcc_language_config config, rcc_class_id class_id)
const char * rccConfigGetCurrentCharsetName (rcc_language_config config, rcc_class_id class_id)
int rccConfigSetEngine (rcc_language_config config, rcc_engine_id engine_id)
int rccConfigSetCharset (rcc_language_config config, rcc_class_id class_id, rcc_charset_id charset_id)
int rccConfigSetEngineByName (rcc_language_config config, const char *name)
int rccConfigSetCharsetByName (rcc_language_config config, rcc_class_id class_id, const char *name)
rcc_charset_id rccConfigGetLocaleCharset (rcc_language_config config, const char *locale_variable)
const char * rccGetEngineName (rcc_context ctx, rcc_engine_id engine_id)
const char * rccGetCharsetName (rcc_context ctx, rcc_charset_id charset_id)
rcc_engine_id rccGetEngineByName (rcc_context ctx, const char *name)
rcc_charset_id rccGetCharsetByName (rcc_context ctx, const char *name)
rcc_engine_id rccGetSelectedEngine (rcc_context ctx)
const char * rccGetSelectedEngineName (rcc_context ctx)
rcc_engine_id rccGetCurrentEngine (rcc_context ctx)
const char * rccGetCurrentEngineName (rcc_context ctx)
rcc_charset_id rccGetSelectedCharset (rcc_context ctx, rcc_class_id class_id)
const char * rccGetSelectedCharsetName (rcc_context ctx, rcc_class_id class_id)
rcc_charset_id rccGetCurrentCharset (rcc_context ctx, rcc_class_id class_id)
const char * rccGetCurrentCharsetName (rcc_context ctx, rcc_class_id class_id)
int rccSetEngine (rcc_context ctx, rcc_engine_id engine_id)
int rccSetCharset (rcc_context ctx, rcc_class_id class_id, rcc_charset_id charset_id)
int rccSetEngineByName (rcc_context ctx, const char *name)
int rccSetCharsetByName (rcc_context ctx, rcc_class_id class_id, const char *name)
rcc_charset_id rccGetLocaleCharset (rcc_context ctx, const char *locale_variable)
rcc_language_ptrrccGetLanguageList (rcc_context ctx)
rcc_charsetrccGetCharsetList (rcc_context ctx, rcc_language_id language_id)
rcc_engine_ptrrccGetEngineList (rcc_context ctx, rcc_language_id language_id)
rcc_charsetrccGetCurrentCharsetList (rcc_context ctx)
rcc_engine_ptrrccGetCurrentEngineList (rcc_context ctx)
rcc_charsetrccGetCurrentAutoCharsetList (rcc_context ctx)
rcc_class_ptrrccGetClassList (rcc_context ctx)
size_t rccStringCheck (const char *str)
size_t rccStringSizedCheck (const char *str, size_t len)
rcc_language_id rccStringGetLanguage (rcc_const_string str)
const char * rccStringGetString (rcc_const_string str)
char * rccStringExtractString (rcc_const_string str)
const char * rccGetString (const char *str)
const char * rccSizedGetString (const char *str, size_t len)
int rccStringCmp (const char *str1, const char *str2)
int rccStringNCmp (const char *str1, const char *str2, size_t n)
int rccStringCaseCmp (const char *str1, const char *str2)
int rccStringNCaseCmp (const char *str1, const char *str2, size_t n)
rcc_iconv rccIConvOpen (const char *from, const char *to)
void rccIConvClose (rcc_iconv icnv)
size_t rccIConvRecode (rcc_iconv icnv, char *outbuf, size_t outsize, const char *buf, size_t size)
rcc_string rccSizedFrom (rcc_context ctx, rcc_class_id class_id, const char *buf, size_t len)
char * rccSizedTo (rcc_context ctx, rcc_class_id class_id, const rcc_string buf, size_t *rlen)
char * rccSizedRecode (rcc_context ctx, rcc_class_id from, rcc_class_id to, const char *buf, size_t len, size_t *rlen)
char * rccFS (rcc_context ctx, rcc_class_id from, rcc_class_id to, const char *fspath, const char *path, const char *filename)
rcc_string rccSizedFromCharset (rcc_context ctx, const char *charset, const char *buf, size_t len)
char * rccSizedToCharset (rcc_context ctx, const char *charset, const rcc_string buf, size_t *rlen)
char * rccSizedRecodeToCharset (rcc_context ctx, rcc_class_id class_id, const char *charset, const rcc_string buf, size_t len, size_t *rlen)
char * rccSizedRecodeFromCharset (rcc_context ctx, rcc_class_id class_id, const char *charset, const char *buf, size_t len, size_t *rlen)
char * rccSizedRecodeCharsets (rcc_context ctx, const char *from, const char *to, const char *buf, size_t len, size_t *rlen)
rcc_config rccGetConfiguration ()
int rccSave (rcc_context ctx, const char *name)
int rccLoad (rcc_context ctx, const char *name)
rcc_engine_internal rccEngineGetInternal (rcc_engine_context ctx)
rcc_languagerccEngineGetLanguage (rcc_engine_context ctx)
rcc_context rccEngineGetRccContext (rcc_engine_context ctx)
rcc_compiled_configuration rccGetCompiledConfiguration ()
int rccLocaleGetClassByName (const char *locale)
int rccLocaleGetLanguage (char *result, const char *lv, unsigned int n)
int rccLocaleGetCharset (char *result, const char *lv, unsigned int n)


Define Documentation

#define RCC_CC_FLAG_HAVE_BERKLEY_DB   0x01
 

The Berkley DB support is compiled in

#define RCC_CC_FLAG_HAVE_DYNAMIC_ENGINES   0x02
 

The dynamic engine plugins support is compiled in

#define RCC_CC_FLAG_HAVE_ENCA   0x04
 

Enca engine is compiled in

#define RCC_CC_FLAG_HAVE_RCD   0x08
 

LibRCD engine is compiled in

#define RCC_CLASS_FLAG_CONST   0x01
 

Forbid change class value using Library API

#define RCC_CLASS_FLAG_SKIP_SAVELOAD   0x02
 

Forbid saving and loading of class value

#define RCC_FLAG_NO_DEFAULT_CONFIGURATION   1
 

Do not load default language configuration

#define RCC_MAX_ALIASES   64
 

#define RCC_MAX_CHARSET_CHARS   16
 

#define RCC_MAX_CHARSETS   16
 

#define RCC_MAX_CLASSES   16
 

#define RCC_MAX_ENGINES   5
 

#define RCC_MAX_ERRORS   3
 

#define RCC_MAX_LANGUAGE_CHARS   16
 

#define RCC_MAX_LANGUAGES   64
 

#define RCC_MAX_VARIABLE_CHARS   16
 

#define RCC_OPTION_LEARNING_FLAG_LEARN   2
 

Cache recodings in BerkeleyDB recoding cache for future use

#define RCC_OPTION_LEARNING_FLAG_USE   1
 

Use BerkeleyDB recodings cache for encoding detection

#define rccFrom ctx,
class_id,
buf   )     rccSizedFrom(ctx, class_id, buf, 0)
 

#define rccFromCharset ctx,
charset,
buf   )     rccSizedFromCharset(ctx, charset, buf, 0)
 

#define rccRecode ctx,
from,
to,
buf   )     rccSizedRecode(ctx, from, to, buf, 0, NULL)
 

#define rccRecodeCharsets ctx,
from,
to,
buf   )     rccSizedRecodeCharsets(ctx, from, to, buf, 0, NULL)
 

#define rccRecodeFromCharset ctx,
class_id,
charset,
buf   )     rccSizedRecodeFromCharset(ctx, class_id, charset, buf, 0, NULL)
 

#define rccRecodeToCharset ctx,
class_id,
charset,
buf   )     rccSizedRecodeToCharset(ctx, class_id, charset, buf, 0, NULL)
 

#define rccTo ctx,
class_id,
buf   )     rccSizedTo(ctx, class_id, buf, NULL)
 

#define rccToCharset ctx,
charset,
buf   )     rccSizedToCharset(ctx, charset, buf, NULL)
 


Typedef Documentation

typedef unsigned char rcc_alias_id
 

Alias ID

typedef unsigned char rcc_autocharset_id
 

Autocharset ID.

  • -1 is error
  • >0 is some encoding

typedef const char* rcc_charset
 

Encoding name.

typedef unsigned char rcc_charset_id
 

Charset ID.

  • 0 is default charset
  • -1 is error
  • >0 is some charset

typedef rcc_charset rcc_charset_list[RCC_MAX_CHARSETS+1]
 

List of Encoding names

typedef const struct rcc_class_t rcc_class
 

typedef const struct rcc_class_default_charset_t rcc_class_default_charset
 

typedef int rcc_class_id
 

Class ID.

typedef rcc_class_ptr rcc_class_list[RCC_MAX_CLASSES+1]
 

typedef const struct rcc_class_t* rcc_class_ptr
 

typedef enum rcc_class_type_t rcc_class_type
 

Enumeration represents type of class.

typedef const struct rcc_compiled_configuration_t* rcc_compiled_configuration
 

typedef struct rcc_compiled_configuration_t rcc_compiled_configuration_s
 

typedef void* rcc_config
 

typedef const char* rcc_const_string
 

Intermediate string format. RCC_string can be manipulated as standard NULL terminated string. However it contains small header with information about string language. All strings are encoded using UTF-8 encoding.

typedef struct rcc_context_t* rcc_context
 

Current Working Context

typedef unsigned int rcc_db4_flags
 

Berkeley DB initialization flags

typedef struct rcc_engine_t rcc_engine
 

typedef struct rcc_engine_context_t* rcc_engine_context
 

Encoding Detection Engine Context. Containes considered information about engine, which can be extracted using API functions.

See also:
rccEngineGetInternal

rccEngineGetLanguage

rccEngineGetRccContext

typedef void(* rcc_engine_free_function)(rcc_engine_context ctx)
 

Engine destructor function

typedef rcc_autocharset_id(* rcc_engine_function)(rcc_engine_context ctx, const char *buf, int len)
 

Engine encoding detection function.

Parameters:
ctx is engine context
buf is string encoded in unknow encoding
len is exact size of string or 0 (size will be detected with strlen)
Returns:
the rcc_autocharset_id of the detected encoding or -1 in case of error

typedef unsigned char rcc_engine_id
 

Engine ID.

  • -1 is non configured (first available will be used if any)
  • 0 autodetection is switched off
  • >0 is some auto-engine

typedef rcc_engine_internal(* rcc_engine_init_function)(rcc_engine_context ctx)
 

Engine constructor function

Parameters:
ctx is engine context
See also:
rccEngineGetInternal

rccEngineGetLanguage

rccEngineGetRccContext

Returns:
pointer on desired internal data to be stored in engine_context.

typedef void* rcc_engine_internal
 

Engine internal data

typedef rcc_engine_ptr rcc_engine_list[RCC_MAX_ENGINES+1]
 

typedef rcc_engine* rcc_engine_ptr
 

typedef struct rcc_iconv_t* rcc_iconv
 

recoding context

typedef unsigned int rcc_init_flags
 

RCC context initialization flags

typedef struct rcc_language_t rcc_language
 

typedef struct rcc_language_alias_t rcc_language_alias
 

typedef rcc_language_alias_ptr rcc_language_alias_list[RCC_MAX_ALIASES+1]
 

typedef rcc_language_alias* rcc_language_alias_ptr
 

typedef struct rcc_language_config_t* rcc_language_config
 

Current Language Configuration: Information about current 'class encodings', and selected 'Encoding Detection Engine'

typedef unsigned char rcc_language_id
 

Language ID.

  • 0 is default language
  • -1 is error
  • 1 usually represents "LibRCC off" language
  • >1 is some language

typedef rcc_language_ptr rcc_language_list[RCC_MAX_LANGUAGES+1]
 

typedef rcc_language* rcc_language_ptr
 

typedef enum rcc_option_t rcc_option
 

List of options available

typedef struct rcc_option_range_t rcc_option_range
 

Descriptionm of value range

typedef enum rcc_option_range_type_t rcc_option_range_type
 

Description of option values range type

typedef enum rcc_option_type_t rcc_option_type
 

List of option types

typedef int rcc_option_value
 

typedef rcc_engine*(* rcc_plugin_engine_info_function)(const char *lang)
 

typedef char* rcc_string
 

Intermediate string format. RCC_string can be manipulated as standard NULL terminated string. However it contains small header with information about string language. All strings are encoded using UTF-8 encoding.


Enumeration Type Documentation

enum rcc_class_type_t
 

Enumeration represents type of class.

Enumeration values:
RCC_CLASS_INVALID  Invalid value
RCC_CLASS_STANDARD  Standard class
RCC_CLASS_KNOWN  Class encoding is known and no autodetection should be performed
RCC_CLASS_FS  Class strings are representing file names

00273                               {
00274     RCC_CLASS_INVALID = 0,      
00275     RCC_CLASS_STANDARD,         
00276     RCC_CLASS_KNOWN,            
00277     RCC_CLASS_FS                
00278 } rcc_class_type;

enum rcc_option_range_type_t
 

Description of option values range type

Enumeration values:
RCC_OPTION_RANGE_TYPE_BOOLEAN  Boolean option
RCC_OPTION_RANGE_TYPE_RANGE  Range of integer values
RCC_OPTION_RANGE_TYPE_FLAGS  Set of boolean flags
RCC_OPTION_RANGE_TYPE_MENU  Enumeration
RCC_OPTION_RANGE_TYPE_MAX 

enum rcc_option_t
 

List of options available

Enumeration values:
RCC_OPTION_LEARNING_MODE  Recoding Caching mode (OFF/ON/RELEARN/LEARN)
RCC_OPTION_AUTODETECT_FS_TITLES  Detect titles of RCC_CLASS_FS classes
RCC_OPTION_AUTODETECT_FS_NAMES  Try to find encoding of RCC_CLASS_FS by accessing fs
RCC_OPTION_CONFIGURED_LANGUAGES_ONLY  Use only configured languages or languages with auto-engines
RCC_MAX_OPTIONS 

enum rcc_option_type_t
 

List of option types

Enumeration values:
RCC_OPTION_TYPE_INVISIBLE  Invisible option. Wouldn't be represented in UI menu
RCC_OPTION_TYPE_STANDARD  Standard option.
RCC_OPTION_TYPE_MAX 


Function Documentation

rcc_language_config rccCheckConfig rcc_context  ctx,
rcc_language_id  language_id
 

Check if configuration is initialized for supplied language.

Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is concerned language id
Returns:
configuration context if:
  • language_id is particular language, not default one
  • language already intialized
  • language is not dummy (Disable LibRCC) language otherwise NULL is returned

rcc_charset_id rccConfigGetCharsetByName rcc_language_config  config,
const char *  name
 

Function finds encoding id by the supplied name.

Parameters:
config is language configuration
name is encoding name
Returns:
encoding id [0-n] or -1 if not found.

const char* rccConfigGetCharsetName rcc_language_config  config,
rcc_charset_id  charset_id
 

Return supplied encoding name

Parameters:
config is language configuration
charset_id is desired charset
Returns:
selected encoding name or NULL in case of error.

rcc_charset_id rccConfigGetCurrentCharset rcc_language_config  config,
rcc_class_id  class_id
 

Return current encoding_id. The default value will be resolved to paticular encoding id. The following procedure is used to detect default encoding:

  • If the parrent class is defined in #defcharset, - return current encoding of parrent class.
  • If the locale variable is defined in #defcharset and config language coincide with locale language, use locale encoding.
  • If the default value for config language is defined in #defvalue return that default value.
  • Return language with id 0. Normally this should be dummy language which indicates that RCC library is not used.

Parameters:
config is language configuration
class_id is encoding class
Returns:
selected charset id [1-n] or -1 in case of error

const char* rccConfigGetCurrentCharsetName rcc_language_config  config,
rcc_class_id  class_id
 

Return current encoding name.

See also:
rccConfigGetCurrentCharset
Parameters:
config is language configuration
class_id is encoding class
Returns:
current charset name or NULL in case of error.

rcc_engine_id rccConfigGetCurrentEngine rcc_language_config  config  ) 
 

Return current engine_id. The default value will be resolved to paticular engine id. Normally, the id of the first available engine will be returned. If no engines registered for supplied language the 0 will be returned, indicating id of dummy(dissabled) engine.

Parameters:
config is language configuration
Returns:
selected engine id [0-n] or -1 in case of error
  • 0 engines are dissabled
  • >0 paticular engine id

const char* rccConfigGetCurrentEngineName rcc_language_config  config  ) 
 

Return current engine name.

See also:
rccConfigGetCurrentEngine
Parameters:
config is language configuration
Returns:
current engine name or NULL in case of error.

rcc_engine_id rccConfigGetEngineByName rcc_language_config  config,
const char *  name
 

Function finds engine id by the supplied name.

Parameters:
config is language configuration
name is engine name
Returns:
engine id [0-n] or -1 if not found

const char* rccConfigGetEngineName rcc_language_config  config,
rcc_engine_id  engine_id
 

Return supplied engine name

Parameters:
config is language configuration
engine_id is desired engine
Returns:
selected engine name or NULL in case of error.

rcc_charset_id rccConfigGetLocaleCharset rcc_language_config  config,
const char *  locale_variable
 

Function will return encoding id of charset specified by locale configuration.

Parameters:
config is language configuration
locale_variable is locale variable (Default(NULL) is LC_CTYPE)
Returns:
encoding id

rcc_charset_id rccConfigGetSelectedCharset rcc_language_config  config,
rcc_class_id  class_id
 

Return selected encoding id.

Parameters:
config is language configuration
class_id is encoding class
Returns:
selected encoding id [0-n] or -1 in case of error
  • 0 default encoding
  • >0 paticular encoding id

const char* rccConfigGetSelectedCharsetName rcc_language_config  config,
rcc_class_id  class_id
 

Return selected encoding name.

See also:
rccConfigGetSelectedCharset
Parameters:
config is language configuration
class_id is charset encodings
Returns:
selected encodings name ('default' will be returned if engine not configured) or NULL in case of error.

rcc_engine_id rccConfigGetSelectedEngine rcc_language_config  config  ) 
 

Return selected engin id.

Parameters:
config is language configuration
Returns:
selected engine id [-1-n]
  • -1 engine is not configured and first available will be used
  • 0 engines are dissabled
  • >0 paticular engine id

const char* rccConfigGetSelectedEngineName rcc_language_config  config  ) 
 

Return selected engine name.

See also:
rccConfigGetSelectedEngine
Parameters:
config is language configuration
Returns:
selected engine name ('default' will be returned if engine not configured) or NULL in case of error.

int rccConfigSetCharset rcc_language_config  config,
rcc_class_id  class_id,
rcc_charset_id  charset_id
 

Set current encoding.

Parameters:
config is language configuration
class_id is encoding class
charset_id is new charset id [0-n]. The 0 will switch charset to encoding state.
Returns:
non-zero value in case of error

int rccConfigSetCharsetByName rcc_language_config  config,
rcc_class_id  class_id,
const char *  name
 

Set current encoding by name.

Parameters:
config is language configuration
class_id is encoding class
name is the short name of new encoding ("default" is okey).
Returns:
non-zero value in case of error

int rccConfigSetEngine rcc_language_config  config,
rcc_engine_id  engine_id
 

Set current engine.

Parameters:
config is language configuration
engine_id is new language id [-1-n]. If -1 supplied the engine will go in non-configured state.
Returns:
non-zero value in case of error

int rccConfigSetEngineByName rcc_language_config  config,
const char *  name
 

Set current engine by name.

Parameters:
config is language configuration
name is the short name of new engine ("default" is okey).
Returns:
non-zero value in case of error

rcc_context rccCreateContext const char *  locale_variable,
unsigned int  max_languages,
unsigned int  max_classes,
rcc_class_ptr  defclasses,
rcc_init_flags  flags
 

Initialize working context.

Parameters:
locale_variable is variable to get locale from (Default: LC_CTYPE).
max_languages is maximal number of languages supported by context. (Default: detect)
max_classes is maximal number of classes (Default: detect)
defclasses is list of encoding classes (Default: will add later)
flags is option flag (Default: nothing)
See also:
RCC_FLAG_NO_DEFAULT_CONFIGURATION
Returns:
working context or NULL in case of error

rcc_engine_internal rccEngineGetInternal rcc_engine_context  ctx  ) 
 

rcc_language* rccEngineGetLanguage rcc_engine_context  ctx  ) 
 

rcc_context rccEngineGetRccContext rcc_engine_context  ctx  ) 
 

void rccFree  ) 
 

Library Cleanup function.

void rccFreeContext rcc_context  ctx  ) 
 

Free all memory used by working context and destroy it.

Parameters:
ctx is working context to be destroyed.

char* rccFS rcc_context  ctx,
rcc_class_id  from,
rcc_class_id  to,
const char *  fspath,
const char *  path,
const char *  filename
 

Recode file name between different encoding classes. Normally, should be used to convert string from the file list to real file system names. The autoprobing of names is enabled depending on the output encoding class configuration and current options.

See also:
rcc_class_t

rcc_class_type_t

rcc_option_t

The conversion is partly relays on rccSizedFrom.
See also:
rccSizedFrom
Parameters:
ctx is working context ( or default one if NULL supplied )
from is source encoding class
to is destination encoding class
fspath is path to the filesystem where file are located.
path is file path
filename is file name
Returns:
is recoded file name or NULL if recoding is not required or failed. It is up to the caller to free memory.

rcc_charset_id rccGetCharsetByName rcc_context  ctx,
const char *  name
 

rcc_charset* rccGetCharsetList rcc_context  ctx,
rcc_language_id  language_id
 

const char* rccGetCharsetName rcc_context  ctx,
rcc_charset_id  charset_id
 

rcc_class_ptr* rccGetClassList rcc_context  ctx  ) 
 

rcc_class_type rccGetClassType rcc_context  ctx,
rcc_class_id  class_id
 

Determines 'class type' of supplied class.

Parameters:
ctx is working context ( or default one if NULL supplied )
class_id is class id
Returns:
class type or -1 in case of a error.

rcc_compiled_configuration rccGetCompiledConfiguration  ) 
 

Get information about library compilation environment

rcc_language_config rccGetConfig rcc_context  ctx,
rcc_language_id  language_id
 

Initializes language configuration if not yet configured and returns pointer on that configuration. If default language is supplied (language_id = 0), the language id will be resolved to particular language and config of that language will be returned.

Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is concerned language id
Returns:
configuration context. The NULL is returned in the case of errors or dummy (Dissable LibRCC) language is selected.

rcc_language_config rccGetConfigByName rcc_context  ctx,
const char *  name
 

Initializes language configuration if not yet configured and returns pointer on that configuration.

Parameters:
ctx is working context ( or default one if NULL supplied )
name is concerned language name
Returns:
configuration context or NULL in case of error

rcc_config rccGetConfiguration  ) 
 

rcc_charset* rccGetCurrentAutoCharsetList rcc_context  ctx  ) 
 

rcc_charset_id rccGetCurrentCharset rcc_context  ctx,
rcc_class_id  class_id
 

rcc_charset* rccGetCurrentCharsetList rcc_context  ctx  ) 
 

const char* rccGetCurrentCharsetName rcc_context  ctx,
rcc_class_id  class_id
 

rcc_language_config rccGetCurrentConfig rcc_context  ctx  ) 
 

Returns pointer on the current language configuration (Initializes it as well if required)

Parameters:
ctx is working context ( or default one if NULL supplied )
Returns:
configuration context or NULL in case of error

rcc_engine_id rccGetCurrentEngine rcc_context  ctx  ) 
 

rcc_engine_ptr* rccGetCurrentEngineList rcc_context  ctx  ) 
 

const char* rccGetCurrentEngineName rcc_context  ctx  ) 
 

rcc_language_id rccGetCurrentLanguage rcc_context  ctx  ) 
 

Return current language id, resolving default language to particular one if necessary. See more details how default language is resolved:

See also:
rccGetRealLanguage
Parameters:
ctx is working context ( or default one if NULL supplied )
Returns:
current language id [1-n] or -1 in case of error

const char* rccGetCurrentLanguageName rcc_context  ctx  ) 
 

Return current language name. #

See also:
rccGetCurrentLanguage
Parameters:
ctx is working context ( or default one if NULL supplied )
Returns:
current language id [1-n] or -1 in case of error

rcc_engine_id rccGetEngineByName rcc_context  ctx,
const char *  name
 

rcc_engine_ptr* rccGetEngineList rcc_context  ctx,
rcc_language_id  language_id
 

const char* rccGetEngineName rcc_context  ctx,
rcc_engine_id  engine_id
 

rcc_language_id rccGetLanguageByName rcc_context  ctx,
const char *  name
 

Finds language id by the supplied name.

Parameters:
ctx is working context ( or default one if NULL supplied )
name is language name
Returns:
language id [0-n] or -1 if not found.

rcc_language_ptr* rccGetLanguageList rcc_context  ctx  ) 
 

const char* rccGetLanguageName rcc_context  ctx,
rcc_language_id  language_id
 

Determines name of the supplied language.

Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is 'language id' of desired language. For default language the 'default' value will be returned.
Returns:
language name or NULL in case of a error.

rcc_charset_id rccGetLocaleCharset rcc_context  ctx,
const char *  locale_variable
 

rcc_option_value rccGetOption rcc_context  ctx,
rcc_option  option
 

Return option value.

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
Returns:
current option value or -1 in case of error

rcc_option rccGetOptionByName const char *  name  ) 
 

Get option by short name.

Parameters:
name is option name
Returns:
option or -1 in case of error

const char* rccGetOptionName rcc_option  option  ) 
 

Get short name of supplied option.

Parameters:
option is option
Returns:
option range or NULL in case of error

rcc_option_value rccGetOptionValueByName rcc_option  option,
const char *  name
 

Get option value by short name.

Parameters:
option is option
name is value name
Returns:
option value or -1 in case of error

const char* rccGetOptionValueName rcc_option  option,
rcc_option_value  value
 

Get short name of supplied option value.

Parameters:
option is option
value is value of #option
Returns:
option value name or NULL in case of error

rcc_language_id rccGetRealLanguage rcc_context  ctx,
rcc_language_id  language_id
 

This function resolves default languages. If positive language id is supplied it will be returned back unchanged. The default language (0 is supplied as language id) will be resolved to some particular language. The following procedure will be used:

  • 1. Detect Language by locale
  • 2. Check if language intialized if RCC_OPTION_CONFIGURED_LANGUAGES_ONLY is set
  • 3. If one of the previous steps is failed, select first available language (id=1). Usually it should be 'LibRCC off'.

Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is language id
Returns:
resolved language id [1-n] or -1 in case of error.

const char* rccGetRealLanguageName rcc_context  ctx,
rcc_language_id  language_id
 

Return considered language name, resolving default language if necessary.

See also:
rccGetRealLanguage
Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is language id
Returns:
resolved language name or NULL in case of error.

rcc_charset_id rccGetSelectedCharset rcc_context  ctx,
rcc_class_id  class_id
 

const char* rccGetSelectedCharsetName rcc_context  ctx,
rcc_class_id  class_id
 

rcc_engine_id rccGetSelectedEngine rcc_context  ctx  ) 
 

const char* rccGetSelectedEngineName rcc_context  ctx  ) 
 

rcc_language_id rccGetSelectedLanguage rcc_context  ctx  ) 
 

Return selected language id.

Parameters:
ctx is working context ( or default one if NULL supplied )
Returns:
selected language id [0-n] or -1 in case of error

const char* rccGetSelectedLanguageName rcc_context  ctx  ) 
 

Return selected language name.

See also:
rccGetSelectedLanguage
Parameters:
ctx is working context ( or default one if NULL supplied )
Returns:
selected language name or NULL in case of error.

const char* rccGetString const char *  str  ) 
 

If str is rcc_string function will return pointer on UTF-8 string kept inside, otherwise pointer on the passed string is returned.

Parameters:
str is null-terminated string
Returns:
pointer on constant string

void rccIConvClose rcc_iconv  icnv  ) 
 

Close recoding context.

Parameters:
icnv is recoding context

rcc_iconv rccIConvOpen const char *  from,
const char *  to
 

Open recoding context.

Parameters:
from is source encoding
to is destination encoding
Returns:
  • NULL if no recoding is required
  • Pointer on initialized context if successful
  • Pointer on errnous context in the case of error

size_t rccIConvRecode rcc_iconv  icnv,
char *  outbuf,
size_t  outsize,
const char *  buf,
size_t  size
 

Recodes chunk of data.

Parameters:
icnv is recoding context
outbuf is preallocated output buffer
outsize is size of output buffer (striped string will be returned if buffer to small)
buf is data for recoding
size is size of the data
Returns:
number of recoded bytes in output buffer or -1 in the case of error

int rccInit  ) 
 

Library Initialization function. Should be called prior to all any library manipulation.

int rccInitDb4 rcc_context  ctx,
const char *  name,
rcc_db4_flags  flags
 

Enables Berkeley DB recodings caching for specified working context.

Parameters:
ctx is working context
name is database name (can be shared between different applications)
flags are reserved for future.
Returns:
non-zero value in case of error

int rccInitDefaultContext const char *  locale_variable,
unsigned int  max_languages,
unsigned int  max_classes,
rcc_class_ptr  defclasses,
rcc_init_flags  flags
 

Initialize default working context (used then no context supplied). Previously opened default context will be freed.

Parameters:
locale_variable is variable to get locale from (Default: LC_CTYPE).
max_languages is maximal number of languages supported by context. (Default: detect)
max_classes is maximal number of classes (Default: detect)
defclasses is list of encoding classes (Default: will add later)
flags is option flag (Default: nothing)
See also:
RCC_FLAG_NO_DEFAULT_CONFIGURATION
Returns:
non-zero value in case of error

rcc_charset_id rccLanguageRegisterCharset rcc_language language,
rcc_charset  charset
 

Register new encoding belonging to language in supplied working context

Parameters:
language is language charset should be added to ( or default one if NULL supplied )
charset is pointer on charset name (shouldn't be freed before library deinitialization).
Returns:
registered charset id or -1 in case of a error.

rcc_engine_id rccLanguageRegisterEngine rcc_language language,
rcc_engine engine
 

Register new Engine in supplied working context

Parameters:
language is language charset should be added to ( or default one if NULL supplied )
engine is pointer on engine description (shouldn't be freed before library deinitialization).
Returns:
registered engine id or -1 in case of a error.

int rccLoad rcc_context  ctx,
const char *  name
 

Load Configuration.

Parameters:
ctx is working context ( or default one if NULL supplied )
name is configuration file name ( can be shared between multiple applications! )
Returns:
non-zero in the case of errors.

int rccLocaleGetCharset char *  result,
const char *  lv,
unsigned int  n
 

int rccLocaleGetClassByName const char *  locale  ) 
 

int rccLocaleGetLanguage char *  result,
const char *  lv,
unsigned int  n
 

int rccLockConfiguration rcc_context  ctx,
unsigned int  lock_code
 

rcc_option_range* rccOptionGetRange rcc_context  ctx,
rcc_option  option
 

Return range description for specified option

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
Returns:
option range or -1 in case of error

rcc_option_type rccOptionGetType rcc_context  ctx,
rcc_option  option
 

Get current option type.

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
Returns:
current option type or -1 in case of error

int rccOptionIsDefault rcc_context  ctx,
rcc_option  option
 

Tests if option have unchanged default value.

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
Returns:
current option value or -1 in case of error

int rccOptionSetDefault rcc_context  ctx,
rcc_option  option
 

Sets option to its default value.

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
Returns:
non-zero value in case of error

rcc_class_id rccRegisterClass rcc_context  ctx,
rcc_class cl
 

Register additional class

Parameters:
ctx is working context ( or default one if NULL supplied )
cl is pointer on the class description (shouldn't be freed before library deinitialization).
Returns:
registered class id or -1 in case of a error.

rcc_language_id rccRegisterLanguage rcc_context  ctx,
rcc_language language
 

Register new language in supplied working context

Parameters:
ctx is working context ( or default one if NULL supplied )
language is pointer on language description (shouldn't be freed before library deinitialization).
Returns:
registered language id or -1 in case of a error.

rcc_alias_id rccRegisterLanguageAlias rcc_context  ctx,
rcc_language_alias alias
 

Register new language alias in supplied working context

Parameters:
ctx is working context ( or default one if NULL supplied )
alias is pointer on alias description (shouldn't be freed before library deinitialization).
Returns:
registered alias id or -1 in case of a error.

int rccSave rcc_context  ctx,
const char *  name
 

Save Configuration.

Parameters:
ctx is working context ( or default one if NULL supplied )
name is configuration file name ( can be shared between multiple applications! )
Returns:
non-zero in the case of errors.

int rccSetCharset rcc_context  ctx,
rcc_class_id  class_id,
rcc_charset_id  charset_id
 

int rccSetCharsetByName rcc_context  ctx,
rcc_class_id  class_id,
const char *  name
 

int rccSetEngine rcc_context  ctx,
rcc_engine_id  engine_id
 

int rccSetEngineByName rcc_context  ctx,
const char *  name
 

int rccSetLanguage rcc_context  ctx,
rcc_language_id  language_id
 

Set current language.

Parameters:
ctx is working context ( or default one if NULL supplied )
language_id is new language id [0-n]. Set to default state is Ok.
Returns:
non-zero value in case of error

int rccSetLanguageByName rcc_context  ctx,
const char *  name
 

Set current language by name.

Parameters:
ctx is working context ( or default one if NULL supplied )
name is the short name of new language.
Returns:
non-zero value in case of error

int rccSetOption rcc_context  ctx,
rcc_option  option,
rcc_option_value  value
 

Set option value.

Parameters:
ctx is working context ( or default one if NULL supplied )
option is option
value is option value
Returns:
non-zero value in case of erros

rcc_string rccSizedFrom rcc_context  ctx,
rcc_class_id  class_id,
const char *  buf,
size_t  len
 

Recode string from specified encoding class to rcc_string. Encoding detection engines and recoding cache are used (if possible) to detect original 'buf' encoding. Otherwise the preconfigured encoding of class is assumed.

Parameters:
ctx is working context ( or default one if NULL supplied )
class_id is encoding class
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

rcc_string rccSizedFromCharset rcc_context  ctx,
const char *  charset,
const char *  buf,
size_t  len
 

Recode string from specified encoding to rcc_string.

Parameters:
ctx is working context ( or default one if NULL supplied )
charset is source encoding
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

const char* rccSizedGetString const char *  str,
size_t  len
 

If str is rcc_string function will return pointer on UTF-8 string kept inside, otherwise pointer on the passed string is returned.

Parameters:
str is string (perhaps not zero terminated)
len is exact length of string or 0 (in this case length will be computed using 'strlen'
Returns:
pointer on constant string

char* rccSizedRecode rcc_context  ctx,
rcc_class_id  from,
rcc_class_id  to,
const char *  buf,
size_t  len,
size_t *  rlen
 

Recode string between different encoding classes. The conversion is relays on rccSizedFrom and rccSizedTo functions.

See also:
rccSizedFrom

rccSizedTo

Parameters:
ctx is working context ( or default one if NULL supplied )
from is source encoding class
to is destination encoding class
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

char* rccSizedRecodeCharsets rcc_context  ctx,
const char *  from,
const char *  to,
const char *  buf,
size_t  len,
size_t *  rlen
 

Recode string between specified encodings.

Parameters:
ctx is working context ( or default one if NULL supplied )
from is source encoding
to is destination encoding
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

char* rccSizedRecodeFromCharset rcc_context  ctx,
rcc_class_id  class_id,
const char *  charset,
const char *  buf,
size_t  len,
size_t *  rlen
 

Recode string between specified encoding and encoding class.

The conversion is partly relays on rccSizedTo

See also:
rccSizedTo
Parameters:
ctx is working context ( or default one if NULL supplied )
class_id is destination encoding class
charset is source encoding
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

char* rccSizedRecodeToCharset rcc_context  ctx,
rcc_class_id  class_id,
const char *  charset,
const rcc_string  buf,
size_t  len,
size_t *  rlen
 

Recode string between specified encoding class and encoding.

The conversion is partly relays on rccSizedFrom.

See also:
rccSizedFrom
Parameters:
ctx is working context ( or default one if NULL supplied )
class_id is source encoding class
charset is destination encoding
buf is original string (perhaps not zero terminated)
len is exact size of string or 0. In the last case the size is determined using 'strlen' function.
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

char* rccSizedTo rcc_context  ctx,
rcc_class_id  class_id,
const rcc_string  buf,
size_t *  rlen
 

Recode string from rcc_string to specified encoding class. If encoding class is of 'File System' type, the autoprobing for file names can be performed. In the other cases the rcc_string will be recoded in preconfigured class encoding.

Parameters:
ctx is working context ( or default one if NULL supplied )
class_id is encoding class
buf is original zero terminated string
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

char* rccSizedToCharset rcc_context  ctx,
const char *  charset,
const rcc_string  buf,
size_t *  rlen
 

Recode string from rcc_string to specified encoding.

Parameters:
ctx is working context ( or default one if NULL supplied )
charset is destination encoding
buf is original zero terminated string
rlen in rlen the size of recoded string will be returned.
Returns:
is recoded string or NULL if recoding is not required or failed. It is up to the caller to free memory.

int rccStringCaseCmp const char *  str1,
const char *  str2
 

size_t rccStringCheck const char *  str  ) 
 

Check string header and verify if it is really correct rcc_string.

Parameters:
str is verifying string

int rccStringCmp const char *  str1,
const char *  str2
 

char* rccStringExtractString rcc_const_string  str  ) 
 

Extract UTF-8 string from rcc_string.

Parameters:
str is rcc_string
Returns:
pointer on string or NULL in the case of error. The string should be freed by the caller.

rcc_language_id rccStringGetLanguage rcc_const_string  str  ) 
 

Extract language from rcc_string.

Parameters:
str is rcc_string
Returns:
size of string in bytes or -1 if check failed

const char* rccStringGetString rcc_const_string  str  ) 
 

Returns pointer on UTF-8 string kept inside of rcc_string.

Parameters:
str is rcc_string
Returns:
pointer on constant string or NULL in the case of error

int rccStringNCaseCmp const char *  str1,
const char *  str2,
size_t  n
 

int rccStringNCmp const char *  str1,
const char *  str2,
size_t  n
 

size_t rccStringSizedCheck const char *  str,
size_t  len
 

Check string header and verify if it is really correct rcc_string.

Parameters:
str is verifying string
len is preciese size of str.
Returns:
size of string in bytes or -1 if check failed

int rccUnlockConfiguration rcc_context  ctx,
unsigned int  lock_code
 


Generated on Wed Jul 20 12:37:00 2005 for LibRCC by doxygen 1.3.3