Fix a few Doxygen warnings
[yaz-moved-to-github.git] / include / yaz / icu_I18N.h
1 /* This file is part of the YAZ toolkit.
2  * Copyright (C) 1995-2013 Index Data.
3  * All rights reserved.
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  *     * Redistributions of source code must retain the above copyright
8  *       notice, this list of conditions and the following disclaimer.
9  *     * Redistributions in binary form must reproduce the above copyright
10  *       notice, this list of conditions and the following disclaimer in the
11  *       documentation and/or other materials provided with the distribution.
12  *     * Neither the name of Index Data nor the names of its contributors
13  *       may be used to endorse or promote products derived from this
14  *       software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19  * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27
28 /** \file
29     \brief Internal header for ICU utilities
30
31     These functions, while non-static, are considered unstable and internal
32     and may be renamed for each YAZ release.
33 */
34
35 #ifndef ICU_I18NL_H
36 #define ICU_I18NL_H
37
38 #include <yaz/yconfig.h>
39
40 #include <unicode/utypes.h>   /* Basic ICU data types */
41 #include <unicode/uchar.h>    /* char names           */
42
43 #include <unicode/ucol.h>
44 #include <unicode/ubrk.h>
45
46 #include <yaz/icu.h>
47
48 /* declared structs and functions */
49
50 int icu_check_status (UErrorCode status);
51
52 struct icu_buf_utf16
53 {
54     UChar * utf16;
55     int32_t utf16_len;
56     int32_t utf16_cap;
57 };
58
59 struct icu_buf_utf16 * icu_buf_utf16_create(size_t capacity);
60
61 struct icu_buf_utf16 * icu_buf_utf16_clear(struct icu_buf_utf16 * buf16);
62
63 struct icu_buf_utf16 * icu_buf_utf16_resize(struct icu_buf_utf16 * buf16,
64                                             size_t capacity);
65
66 struct icu_buf_utf16 *icu_buf_utf16_copy(struct icu_buf_utf16 * dest16,
67                                          const struct icu_buf_utf16 * src16);
68
69 struct icu_buf_utf16 *icu_buf_utf16_append(struct icu_buf_utf16 *dest16,
70                                            const struct icu_buf_utf16 * src16);
71
72 void icu_buf_utf16_log(const char *lead, struct icu_buf_utf16 *src16);
73
74 void icu_buf_utf16_destroy(struct icu_buf_utf16 * buf16);
75
76 struct icu_buf_utf8;
77
78 struct icu_buf_utf8
79 {
80     uint8_t * utf8;
81     int32_t utf8_len;
82     int32_t utf8_cap;
83 };
84
85 struct icu_buf_utf8 * icu_buf_utf8_create(size_t capacity);
86
87 struct icu_buf_utf8 * icu_buf_utf8_clear(struct icu_buf_utf8 * buf8);
88
89 struct icu_buf_utf8 * icu_buf_utf8_resize(struct icu_buf_utf8 * buf8,
90                                           size_t capacity);
91
92 void icu_buf_utf8_destroy(struct icu_buf_utf8 * buf8);
93
94
95 UErrorCode icu_utf16_from_utf8_cstr(struct icu_buf_utf16 * dest16,
96                                     const char * src8cstr,
97                                     UErrorCode * status);
98
99 const char *icu_buf_utf8_to_cstr(struct icu_buf_utf8 *src8);
100
101
102 UErrorCode icu_utf16_to_utf8(struct icu_buf_utf8 *dest8,
103                              const struct icu_buf_utf16 *src16,
104                              UErrorCode * status);
105
106 struct icu_casemap;
107
108 struct icu_casemap * icu_casemap_create(char action, UErrorCode *status);
109
110 struct icu_casemap *icu_casemap_clone(struct icu_casemap *old);
111
112 void icu_casemap_destroy(struct icu_casemap * casemap);
113
114 int icu_casemap_casemap(struct icu_casemap * casemap,
115                         struct icu_buf_utf16 * dest16,
116                         struct icu_buf_utf16 * src16,
117                         UErrorCode *status,
118                         const char *locale);
119
120 int icu_utf16_casemap(struct icu_buf_utf16 * dest16,
121                       struct icu_buf_utf16 * src16,
122                       const char *locale, char action,
123                       UErrorCode *status);
124
125 void icu_sortkey8_from_utf16(UCollator *coll,
126                              struct icu_buf_utf8 * dest8,
127                              struct icu_buf_utf16 * src16,
128                              UErrorCode * status);
129
130 struct icu_tokenizer;
131 struct icu_tokenizer * icu_tokenizer_create(const char *locale, char action,
132                                             UErrorCode *status);
133
134 struct icu_tokenizer *icu_tokenizer_clone(struct icu_tokenizer *old);
135 void icu_tokenizer_destroy(struct icu_tokenizer * tokenizer);
136
137 int icu_tokenizer_attach(struct icu_tokenizer * tokenizer,
138                          struct icu_buf_utf16 * src16, UErrorCode *status);
139
140 int32_t icu_tokenizer_next_token(struct icu_tokenizer * tokenizer,
141                                  struct icu_buf_utf16 * tkn16,
142                                  UErrorCode *status);
143
144 int32_t icu_tokenizer_token_count(struct icu_tokenizer * tokenizer);
145
146 struct icu_transform;
147
148 struct icu_transform * icu_transform_create(const char *id, char action,
149                                             const char *rules,
150                                             UErrorCode *status);
151 struct icu_transform *icu_transform_clone(struct icu_transform *old);
152 void icu_transform_destroy(struct icu_transform * transform);
153
154 int icu_transform_trans(struct icu_transform * transform,
155                         struct icu_buf_utf16 * dest16,
156                         const struct icu_buf_utf16 * src16,
157                         UErrorCode *status);
158
159 struct icu_chain_step;
160
161 int icu_chain_token_number(yaz_icu_chain_t chain);
162
163 yaz_icu_chain_t icu_chain_create(const char * locale,
164                                  int sort,
165                                  UErrorCode * status);
166
167 #endif /* ICU_I18NL_H */
168
169 /*
170  * Local variables:
171  * c-basic-offset: 4
172  * c-file-style: "Stroustrup"
173  * indent-tabs-mode: nil
174  * End:
175  * vim: shiftwidth=4 tabstop=8 expandtab
176  */
177