1// © 2016 and later: Unicode, Inc. and others.
2// License & terms of use: http://www.unicode.org/copyright.html
3/*
4 **********************************************************************
5 *   Copyright (C) 1999-2006, International Business Machines
6 *   Corporation and others.  All Rights Reserved.
7 **********************************************************************
8 *
9 *
10 *  ucnv_io.h:
11 *  defines  variables and functions pertaining to converter name resolution
12 *  aspect of the conversion code
13 */
14
15#ifndef UCNV_IO_H
16#define UCNV_IO_H
17
18#include "unicode/utypes.h"
19
20#if !UCONFIG_NO_CONVERSION
21
22#include "udataswp.h"
23
24#define UCNV_AMBIGUOUS_ALIAS_MAP_BIT 0x8000
25#define UCNV_CONTAINS_OPTION_BIT 0x4000
26#define UCNV_CONVERTER_INDEX_MASK 0xFFF
27#define UCNV_NUM_RESERVED_TAGS 2
28#define UCNV_NUM_HIDDEN_TAGS 1
29
30enum {
31    UCNV_IO_UNNORMALIZED,
32    UCNV_IO_STD_NORMALIZED,
33    UCNV_IO_NORM_TYPE_COUNT
34};
35
36typedef struct {
37    uint16_t stringNormalizationType;
38    uint16_t containsCnvOptionInfo;
39} UConverterAliasOptions;
40
41typedef struct UConverterAlias {
42    const uint16_t *converterList;
43    const uint16_t *tagList;
44    const uint16_t *aliasList;
45    const uint16_t *untaggedConvArray;
46    const uint16_t *taggedAliasArray;
47    const uint16_t *taggedAliasLists;
48    const UConverterAliasOptions *optionTable;
49    const uint16_t *stringTable;
50    const uint16_t *normalizedStringTable;
51
52    uint32_t converterListSize;
53    uint32_t tagListSize;
54    uint32_t aliasListSize;
55    uint32_t untaggedConvArraySize;
56    uint32_t taggedAliasArraySize;
57    uint32_t taggedAliasListsSize;
58    uint32_t optionTableSize;
59    uint32_t stringTableSize;
60    uint32_t normalizedStringTableSize;
61} UConverterAlias;
62
63/**
64 * \var ucnv_io_stripForCompare
65 * Remove the underscores, dashes and spaces from the name, and convert
66 * the name to lower case.
67 * @param dst The destination buffer, which is <= the buffer of name.
68 * @param dst The destination buffer, which is <= the buffer of name.
69 * @see ucnv_compareNames
70 * @return the destination buffer.
71 */
72#if U_CHARSET_FAMILY==U_ASCII_FAMILY
73#   define ucnv_io_stripForCompare ucnv_io_stripASCIIForCompare
74#elif U_CHARSET_FAMILY==U_EBCDIC_FAMILY
75#   define ucnv_io_stripForCompare ucnv_io_stripEBCDICForCompare
76#else
77#   error U_CHARSET_FAMILY is not valid
78#endif
79
80U_CAPI char * U_CALLCONV
81ucnv_io_stripASCIIForCompare(char *dst, const char *name);
82
83U_CAPI char * U_CALLCONV
84ucnv_io_stripEBCDICForCompare(char *dst, const char *name);
85
86/**
87 * Map a converter alias name to a canonical converter name.
88 * The alias is searched for case-insensitively, the converter name
89 * is returned in mixed-case.
90 * Returns NULL if the alias is not found.
91 * @param alias The alias name to be searched.
92 * @param containsOption A return value stating whether the returned converter name contains an option (a comma)
93 * @param pErrorCode The error code
94 * @return the converter name in mixed-case, return NULL if the alias is not found.
95 */
96U_CAPI const char *
97ucnv_io_getConverterName(const char *alias, UBool *containsOption, UErrorCode *pErrorCode);
98
99/**
100 * Return the number of all known converter names (no aliases).
101 * @param pErrorCode The error code
102 * @return the number of all aliases
103 */
104U_CAPI uint16_t
105ucnv_io_countKnownConverters(UErrorCode *pErrorCode);
106
107/**
108 * Swap an ICU converter alias table. See implementation for details.
109 * @internal
110 */
111U_CAPI int32_t U_EXPORT2
112ucnv_swapAliases(const UDataSwapper *ds,
113                 const void *inData, int32_t length, void *outData,
114                 UErrorCode *pErrorCode);
115
116#endif
117
118#endif /* _UCNV_IO */
119
120/*
121 * Hey, Emacs, please set the following:
122 *
123 * Local Variables:
124 * indent-tabs-mode: nil
125 * End:
126 *
127 */
128