scuffed-code/icu4c/source/common/ucnv_io.h
George Rhoten 70debd215f ICU-868 New alias scheme.
X-SVN-Rev: 8975
2002-06-28 23:13:30 +00:00

120 lines
3.3 KiB
C

/*
**********************************************************************
* Copyright (C) 1999-2001, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
*
*
* ucnv_io.h:
* defines variables and functions pertaining to file access, and name resolution
* aspect of the library
*/
#ifndef UCNV_IO_H
#define UCNV_IO_H
#include "unicode/utypes.h"
#define UCNV_AMBIGUOUS_ALIAS_MAP_BIT 0x8000
#define UCNV_CONVERTER_INDEX_MASK 0x7FF
/**
* Map a converter alias name to a canonical converter name.
* The alias is searched for case-insensitively, the converter name
* is returned in mixed-case.
* Returns NULL if the alias is not found.
*/
U_CFUNC const char *
ucnv_io_getConverterName(const char *alias, UErrorCode *pErrorCode);
/**
* The count for ucnv_io_getAliases and ucnv_io_getAlias
*/
U_CFUNC uint16_t
ucnv_io_countAliases(const char *alias, UErrorCode *pErrorCode);
/**
* Search case-insensitively for a converter alias and set aliases to
* a pointer to the list of aliases for the actual converter.
* The first "alias" is the canonical converter name.
* The aliases are stored consecutively, in mixed case, each NUL-terminated.
* There are as many strings in this list as the return value specifies.
* Returns the number of aliases including the canonical converter name,
* or 0 if the alias is not found.
*/
U_CFUNC uint16_t
ucnv_io_getAliases(const char *alias, uint16_t start, const char **aliases, UErrorCode *pErrorCode);
/**
* Search case-insensitively for a converter alias and return
* the (n)th alias.
* Returns NULL if the alias is not found.
*/
U_CFUNC const char *
ucnv_io_getAlias(const char *alias, uint16_t n, UErrorCode *pErrorCode);
/**
* Return the number of all standard names.
*/
U_CFUNC uint16_t
ucnv_io_countStandards(UErrorCode *pErrorCode);
/**
* Return the number of all converter names.
*/
U_CFUNC uint16_t
ucnv_io_countAvailableConverters(UErrorCode *pErrorCode);
/**
* Return the (n)th converter name in mixed case, or NULL
* if there is none (typically, if the data cannot be loaded).
* 0<=index<ucnv_io_countAvailableConverters().
*/
U_CFUNC const char *
ucnv_io_getAvailableConverter(uint16_t n, UErrorCode *pErrorCode);
/**
* Fill an array const char *aliases[ucnv_io_countAvailableConverters()]
* with pointers to all converter names in mixed-case.
*/
U_CFUNC void
ucnv_io_fillAvailableConverters(const char **aliases, UErrorCode *pErrorCode);
/**
* Return the (n)th converter name in mixed case, or NULL
* if there is none (typically, if the data cannot be loaded).
* 0<=index<ucnv_io_countAvailableConverters().
*/
U_CFUNC void
ucnv_io_flushAvailableConverterCache(void);
/**
* Return the number of all aliases (and converter names).
*/
U_CFUNC uint16_t
ucnv_io_countAvailableAliases(UErrorCode *pErrorCode);
/**
* Get the name of the default converter.
* This name is already resolved by <code>ucnv_io_getConverterName()</code>.
*/
U_CFUNC const char *
ucnv_io_getDefaultConverterName(void);
/**
* Set the name of the default converter.
*/
U_CFUNC void
ucnv_io_setDefaultConverterName(const char *name);
#endif /* _UCNV_IO */
/*
* Hey, Emacs, please set the following:
*
* Local Variables:
* indent-tabs-mode: nil
* End:
*
*/