Commit | Line | Data |
---|---|---|
b0322a85 CE |
1 | #ifndef unicode_h |
2 | #define unicode_h | |
3 | ||
4 | /* | |
5 | ** Copyright 2000-2011 Double Precision, Inc. | |
6 | ** See COPYING for distribution information. | |
7 | ** | |
8 | */ | |
9 | ||
10 | #ifdef __cplusplus | |
11 | ||
12 | #include <string> | |
13 | #include <vector> | |
14 | #include <list> | |
15 | ||
16 | extern "C" { | |
17 | #endif | |
18 | ||
19 | #if 0 | |
20 | } | |
21 | #endif | |
22 | ||
23 | #include "unicode/unicode_config.h" | |
24 | ||
25 | #include <stdlib.h> | |
26 | ||
27 | #include <stdio.h> | |
28 | #if HAVE_WCHAR_H | |
29 | #include <wchar.h> | |
30 | #endif | |
31 | ||
32 | #if HAVE_STDDEF_H | |
33 | #include <stddef.h> | |
34 | #endif | |
35 | #include <stdint.h> | |
36 | ||
37 | #include <sys/types.h> | |
38 | ||
39 | typedef uint32_t unicode_char; | |
40 | ||
41 | /* | |
42 | ** The system default character set, from the locale. | |
43 | */ | |
44 | ||
45 | extern const char *unicode_default_chset(); | |
46 | ||
47 | /* Unicode upper/lower/title case conversion functions */ | |
48 | ||
49 | extern unicode_char unicode_uc(unicode_char); | |
50 | extern unicode_char unicode_lc(unicode_char); | |
51 | extern unicode_char unicode_tc(unicode_char); | |
52 | ||
53 | /* | |
54 | ** Look up HTML 4.0/XHTML entity. | |
55 | ** | |
56 | ** n="amp", etc... | |
57 | ** | |
58 | ** Returns the unicode entity value, or 0 if no such entity is defined. | |
59 | */ | |
60 | ||
61 | unicode_char unicode_html40ent_lookup(const char *n); | |
62 | ||
63 | /* | |
64 | ** | |
65 | ** Return "width" of unicode character. | |
66 | ** | |
67 | ** This is defined as follows: for characters having the F or W property in | |
68 | ** tr11 (EastAsianWidth), unicode_wcwidth() returns 2. | |
69 | ** | |
70 | ** Otherwise, characters having the BK, CR, LF, CM, NL, WJ, and ZW line | |
71 | ** breaking property as per tr14, unicode_wcwdith() returns 0. For all other | |
72 | ** cases, 1. | |
73 | ** | |
74 | ** This provides a rough estimate of the "width" of the character if its | |
75 | ** shown on a text console. | |
76 | */ | |
77 | ||
78 | extern int unicode_wcwidth(unicode_char c); | |
79 | extern size_t unicode_wcwidth_str(const unicode_char *c); | |
80 | ||
81 | /* | |
82 | ** The unicode-ish isspace() | |
83 | */ | |
84 | extern int unicode_isspace(unicode_char ch); | |
85 | ||
86 | /* Internal unicode table lookup function */ | |
87 | ||
88 | extern uint8_t unicode_tab_lookup(unicode_char ch, | |
89 | const size_t *unicode_indextab, | |
90 | size_t unicode_indextab_sizeof, | |
91 | const uint8_t (*unicode_rangetab)[2], | |
92 | const uint8_t *unicode_classtab, | |
93 | uint8_t uclass); | |
94 | ||
95 | /* | |
96 | ** Implementation of grapheme cluster boundary rules, as per tr29, | |
97 | ** including GB9a and GB9b. | |
98 | ** | |
99 | ** Returns non-zero if there's a grapheme break between the two referenced | |
100 | ** characters. | |
101 | */ | |
102 | ||
103 | int unicode_grapheme_break(unicode_char a, unicode_char b); | |
104 | ||
105 | /* | |
106 | ** Implementation of line break rules, as per tr14. | |
107 | ** | |
108 | ** Invoke unicode_lb_init() to initialize the linebreaking algorithm. The | |
109 | ** first parameter is a callback function that gets invoked with two | |
110 | ** arguments: UNICODE_LB_{MANDATORY|NONE|ALLOWED}, and a passthrough argument. | |
111 | ** The second parameter to unicode_lb_init() is the opaque passthrough | |
112 | ** pointer, that is passed as the second argument to the callback function | |
113 | ** with no further interpretation. | |
114 | ** | |
115 | ** unicode_lb_init() returns an opaque handle. Invoke unicode_lb_next(), | |
116 | ** passing the handle and one unicode character. Repeatedly invoke | |
117 | ** unicode_lb_next() to specify the input string for the linebreaking | |
118 | ** algorithm, then invoke unicode_lb_end() to finish calculating the | |
119 | ** linebreaking algorithm, and deallocate the opaque linebreaking handle. | |
120 | ** | |
121 | ** The callback function gets invoked once for each invocation of | |
122 | ** unicode_lb_next(). The contract is that before unicode_lb_end() returns, | |
123 | ** the callback function will get invoked the exact number of times that | |
124 | ** unicode_lb_next(), as long as each invocation of the callback function | |
125 | ** returned 0; nothing more, nothing less. The first parameter to the callback | |
126 | ** function will be one of the following values: | |
127 | ** | |
128 | ** UNICODE_LB_MANDATORY - a linebreak is MANDATORY before the corresponding | |
129 | ** character. | |
130 | ** UNICODE_LB_NONE - a linebreak is PROHIBITED before the corresponding | |
131 | ** character. | |
132 | ** UNICODE_LB_ALLOWED - a linebreak is OPTIONAL before the corresponding | |
133 | ** character (the preceding character is a space, or an equivalent). | |
134 | ** | |
135 | ** The callback function should return 0. A non-zero value indicates an | |
136 | ** error, which gets propagated up to the caller. The contract that the | |
137 | ** callback function gets invoked the same number of times that | |
138 | ** unicode_lb_next() gets invoked is now broken. | |
139 | */ | |
140 | ||
141 | #define UNICODE_LB_MANDATORY -1 | |
142 | #define UNICODE_LB_NONE 0 | |
143 | #define UNICODE_LB_ALLOWED 1 | |
144 | ||
145 | struct unicode_lb_info; | |
146 | ||
147 | typedef struct unicode_lb_info *unicode_lb_info_t; | |
148 | ||
149 | /* | |
150 | ** Allocate a linebreaking handle. | |
151 | */ | |
152 | extern unicode_lb_info_t unicode_lb_init(int (*cb_func)(int, void *), | |
153 | void *cb_arg); | |
154 | ||
155 | /* | |
156 | ** Feed the next character through the linebreaking algorithm. | |
157 | ** A non-zero return code indicates that the callback function was invoked | |
158 | ** and it returned a non-zero return code (which is propagated as a return | |
159 | ** value). unicode_lb_end() must still be invoked, in this case. | |
160 | ** | |
161 | ** A zero return code indicates that if the callback function was invoked, | |
162 | ** it returned 0. | |
163 | */ | |
164 | ||
165 | extern int unicode_lb_next(unicode_lb_info_t i, unicode_char ch); | |
166 | ||
167 | /* | |
168 | ** Convenience function that invokes unicode_lb_next() with a list of | |
169 | ** unicode chars. Returns 0 if all invocations of unicode_lb_next() returned | |
170 | ** 0, or the first non-zero return value from unicode_lb_next(). | |
171 | */ | |
172 | ||
173 | extern int unicode_lb_next_cnt(unicode_lb_info_t i, | |
174 | const unicode_char *chars, | |
175 | size_t cnt); | |
176 | ||
177 | /* | |
178 | ** Finish the linebreaking algorithm. | |
179 | ** | |
180 | ** A non-zero return code indicates that the callback function was invoked | |
181 | ** and it returned a non-zero return code (which is propagated as a return | |
182 | ** value). | |
183 | ** | |
184 | ** A zero return code indicates that if the callback function was invoked, | |
185 | ** it returned 0, and that the callback function was invoked exactly the same | |
186 | ** number of times that unicode_lb_next() was invoked. | |
187 | ** | |
188 | ** In all case, the linebreak handle will no longer be valid when this | |
189 | ** function returns. | |
190 | */ | |
191 | ||
192 | extern int unicode_lb_end(unicode_lb_info_t i); | |
193 | ||
194 | /* | |
195 | ** An alternative linebreak API where the callback function receives the | |
196 | ** original unicode character in addition to its linebreak value. | |
197 | ** | |
198 | ** User unicode_lbc_init(), unicode_lbc_next(), and unicode_lbc_end(), whose | |
199 | ** semantics are the same as their _lb_ counterparts. | |
200 | */ | |
201 | ||
202 | struct unicode_lbc_info; | |
203 | ||
204 | typedef struct unicode_lbc_info *unicode_lbc_info_t; | |
205 | ||
206 | extern unicode_lbc_info_t unicode_lbc_init(int (*cb_func)(int, unicode_char, | |
207 | void *), | |
208 | void *cb_arg); | |
209 | extern int unicode_lbc_next(unicode_lbc_info_t i, unicode_char ch); | |
210 | extern int unicode_lbc_end(unicode_lbc_info_t i); | |
211 | ||
212 | /* | |
213 | ** Set linebreaking options. | |
214 | ** | |
215 | ** OPTIONS SUBJECT TO CHANGE. | |
216 | */ | |
217 | ||
218 | extern void unicode_lb_set_opts(unicode_lb_info_t i, int opts); | |
219 | ||
220 | extern void unicode_lbc_set_opts(unicode_lbc_info_t i, int opts); | |
221 | ||
222 | /* | |
223 | ** Tailorization of LB24: Prevent pluses, as in "C++", from breaking. | |
224 | ** | |
225 | ** Adds the following to LB24: | |
226 | ** | |
227 | ** PR x PR | |
228 | ** | |
229 | ** AL x PR | |
230 | ** | |
231 | ** ID x PR | |
232 | **/ | |
233 | #define UNICODE_LB_OPT_PRBREAK 0x0001 | |
234 | ||
235 | ||
236 | /* | |
237 | ** Tailored / breaking rules. | |
238 | ** | |
239 | ** Adds the following rule to LB13: | |
240 | ** | |
241 | ** SY x EX | |
242 | ** | |
243 | ** SY x AL | |
244 | ** | |
245 | ** SY x ID | |
246 | ** | |
247 | ** SP ÷ SY, which takes precedence over "x SY". | |
248 | */ | |
249 | #define UNICODE_LB_OPT_SYBREAK 0x0002 | |
250 | ||
251 | /* | |
252 | ** Tailored / breaking rules. | |
253 | ** | |
254 | ** This reclassifies U+2013 and U+2014 as class WJ, prohibiting breaks before | |
255 | ** and after mdash and ndash. | |
256 | */ | |
257 | #define UNICODE_LB_OPT_DASHWJ 0x0004 | |
258 | ||
259 | /* | |
260 | ** Implemention of word break rules, as per tr29. | |
261 | ** | |
262 | ** Invoke unicode_wb_init() to initialize the wordbreaking algorithm. The | |
263 | ** first parameter is a callback function that gets invoked with two | |
264 | ** arguments: an int flag, and a passthrough argument. The second parameter to | |
265 | ** unicode_wb_init() is the opaque passthrough pointer, that is passed as the | |
266 | ** second argument to the callback function with no further interpretation. | |
267 | ** | |
268 | ** unicode_wb_init() returns an opaque handle. Invoke unicode_wb_next(), | |
269 | ** passing the handle and one unicode character. Repeatedly invoke | |
270 | ** unicode_wb_next() to specify the input string for the wordbreaking | |
271 | ** algorithm, then invoke unicode_wb_end() to finish calculating the | |
272 | ** wordbreaking algorithm, and deallocate the opaque wordbreaking handle. | |
273 | ** | |
274 | ** The callback function gets invoked once for each invocation of | |
275 | ** unicode_wb_next(). The contract is that before unicode_wb_end() returns, | |
276 | ** the callback function will get invoked the exact number of times that | |
277 | ** unicode_wb_next(), as long as each invocation of the callback function | |
278 | ** returned 0; nothing more, nothing less. The first parameter to the callback | |
279 | ** function will be an int. A non-zero value indicates that there is a word | |
280 | ** break between this character and the preceding one. | |
281 | ** | |
282 | ** The callback function should return 0. A non-zero value indicates an | |
283 | ** error, which gets propagated up to the caller. The contract that the | |
284 | ** callback function gets invoked the same number of times that | |
285 | ** unicode_lb_next() gets invoked is now broken. | |
286 | */ | |
287 | ||
288 | struct unicode_wb_info; | |
289 | ||
290 | typedef struct unicode_wb_info *unicode_wb_info_t; | |
291 | ||
292 | /* | |
293 | ** Allocate a wordbreaking handle. | |
294 | */ | |
295 | extern unicode_wb_info_t unicode_wb_init(int (*cb_func)(int, void *), | |
296 | void *cb_arg); | |
297 | ||
298 | /* | |
299 | ** Feed the next character through the wordbreaking algorithm. | |
300 | ** A non-zero return code indicates that the callback function was invoked | |
301 | ** and it returned a non-zero return code (which is propagated as a return | |
302 | ** value). unicode_wb_end() must still be invoked, in this case. | |
303 | ** | |
304 | ** A zero return code indicates that if the callback function was invoked, | |
305 | ** it returned 0. | |
306 | */ | |
307 | ||
308 | extern int unicode_wb_next(unicode_wb_info_t i, unicode_char ch); | |
309 | ||
310 | /* | |
311 | ** Convenience function that invokes unicode_wb_next() with a list of | |
312 | ** unicode chars. Returns 0 if all invocations of unicode_wb_next() returned | |
313 | ** 0, or the first non-zero return value from unicode_wb_next(). | |
314 | */ | |
315 | ||
316 | extern int unicode_wb_next_cnt(unicode_wb_info_t i, | |
317 | const unicode_char *chars, | |
318 | size_t cnt); | |
319 | ||
320 | /* | |
321 | ** Finish the wordbreaking algorithm. | |
322 | ** | |
323 | ** A non-zero return code indicates that the callback function was invoked | |
324 | ** and it returned a non-zero return code (which is propagated as a return | |
325 | ** value). | |
326 | ** | |
327 | ** A zero return code indicates that if the callback function was invoked, | |
328 | ** it returned 0, and that the callback function was invoked exactly the same | |
329 | ** number of times that unicode_wb_next() was invoked. | |
330 | ** | |
331 | ** In all case, the wordbreak handle will no longer be valid when this | |
332 | ** function returns. | |
333 | */ | |
334 | ||
335 | extern int unicode_wb_end(unicode_wb_info_t i); | |
336 | ||
337 | /* | |
338 | ** Search for a word boundary. | |
339 | ** | |
340 | ** Obtain a handle by calling unicode_wbscan_init(), then invoke | |
341 | ** unicode_wbscan_next() to provide a unicode stream, then invoke | |
342 | ** unicode_wbscan_end(). unicode_wbscan_end() returns the number of unicode | |
343 | ** characters from the beginning of the stream until the first word boundary. | |
344 | ** | |
345 | ** You may prematurely stop calling unicode_wbscan_next() once it returns a | |
346 | ** non-0 value, which means that there is sufficient context to compute the | |
347 | ** first word boundary, and all further calls to unicode_wbscan_next() will | |
348 | ** be internal no-ops. | |
349 | */ | |
350 | ||
351 | struct unicode_wbscan_info; | |
352 | ||
353 | typedef struct unicode_wbscan_info *unicode_wbscan_info_t; | |
354 | ||
355 | unicode_wbscan_info_t unicode_wbscan_init(); | |
356 | ||
357 | int unicode_wbscan_next(unicode_wbscan_info_t i, unicode_char ch); | |
358 | ||
359 | size_t unicode_wbscan_end(unicode_wbscan_info_t i); | |
360 | ||
361 | /* | |
362 | ** A buffer that holds unicode characters, and dynamically grows as needed. | |
363 | */ | |
364 | ||
365 | struct unicode_buf { | |
366 | unicode_char *ptr; /* The unicode characters */ | |
367 | size_t size, /* Buffer size */ | |
368 | len, /* How many characters in ptr are initialized */ | |
369 | max; /* Maximum size the buffer can grow to */ | |
370 | }; | |
371 | ||
372 | /* | |
373 | ** Initialize a buffer. Constructor. | |
374 | */ | |
375 | ||
376 | void unicode_buf_init(/* Initialize this structure. ptr, size, len cleared */ | |
377 | struct unicode_buf *p, | |
378 | ||
379 | /* | |
380 | ** Maximum size the buffer can grow to. (size_t)-1 | |
381 | ** means unlimited. | |
382 | */ | |
383 | size_t max); | |
384 | /* | |
385 | ** Like unicode_buf_init, and initialize the new buffer with the contents of | |
386 | ** another buffer. The maximum size of the initialized buffer is exactly the | |
387 | ** number of characters in the existing buffer. This copies a buffer using | |
388 | ** the minimum amount of heap space. | |
389 | */ | |
390 | ||
391 | #define unicode_buf_init_copy(a,b) \ | |
392 | do { \ | |
393 | unicode_buf_init((a), unicode_buf_len(b)); \ | |
394 | unicode_buf_append_buf((a),(b)); \ | |
395 | } while (0) | |
396 | ||
397 | /* | |
398 | ** Deinitialize the buffer. Destructor. Frees memory. | |
399 | */ | |
400 | ||
401 | void unicode_buf_deinit(struct unicode_buf *p); | |
402 | ||
403 | /* | |
404 | ** Official way to access the characters in the unicode buffer. | |
405 | */ | |
406 | #define unicode_buf_ptr(p) ((p)->ptr) | |
407 | ||
408 | /* | |
409 | ** Official way of obtaining the number of characters in the unicode buffer. | |
410 | */ | |
411 | #define unicode_buf_len(p) ((p)->len) | |
412 | ||
413 | /* | |
414 | ** Remove all existing characters from an initialized buffer. Sets len to 0. | |
415 | */ | |
416 | ||
417 | #define unicode_buf_clear(p) ((p)->len=0) | |
418 | ||
419 | /* | |
420 | ** Append characters to the existing characters in the unicode buffer. | |
421 | ** The buffer grows, if needed. If the buffer would exceed its maximum size, | |
422 | ** the extra characters get truncated. | |
423 | ** | |
424 | ** Returns 0 if the characters were appended. -1 for a malloc failure. | |
425 | */ | |
426 | ||
427 | int unicode_buf_append(struct unicode_buf *p, /* The buffer */ | |
428 | const unicode_char *uc, /* Characters to append */ | |
429 | size_t l); /* How many of them */ | |
430 | ||
431 | /* | |
432 | ** Convert an iso-8859-1 char string and invoke unicode_buf_append(). | |
433 | */ | |
434 | ||
435 | void unicode_buf_append_char(struct unicode_buf *dst, | |
436 | const char *str, | |
437 | size_t cnt); | |
438 | ||
439 | /* | |
440 | ** Remove some portion of the unicode buffer | |
441 | */ | |
442 | ||
443 | void unicode_buf_remove(struct unicode_buf *p, /* The buffer */ | |
444 | size_t pos, /* Offset in buffer */ | |
445 | size_t cnt); /* How many to remove */ | |
446 | ||
447 | /* | |
448 | ** Append the contents of an existing buffer to another one. | |
449 | */ | |
450 | ||
451 | #define unicode_buf_append_buf(a,b) \ | |
452 | unicode_buf_append((a), unicode_buf_ptr(b), unicode_buf_len(b)) | |
453 | ||
454 | ||
455 | /* | |
456 | ** The equivalent of strcmp() for unicode buffers. | |
457 | */ | |
458 | ||
459 | int unicode_buf_cmp(const struct unicode_buf *a, | |
460 | const struct unicode_buf *b); | |
461 | ||
462 | /* | |
463 | ** The equivalent of unicode_buf_cmp, except that the second buffer is an | |
464 | ** iso-8859-1 string. | |
465 | */ | |
466 | ||
467 | int unicode_buf_cmp_str(const struct unicode_buf *p, | |
468 | const char *c, /* iso-8859-1 string */ | |
469 | size_t cl); /* Number of chars in c */ | |
470 | ||
471 | /* | |
472 | ** A wrapper for iconv(3). This wrapper provides a different API for iconv(3). | |
473 | ** A handle gets created by libmail_u_convert_init(). | |
474 | ** libmail_u_convert_init() receives a pointer to the output function | |
475 | ** which receives converted character text. | |
476 | ** | |
477 | ** The output function receives a pointer to the converted character text, and | |
478 | ** the number of characters in the converted text. | |
479 | ** | |
480 | ** The character text to convert gets passed, repeatedly, to | |
481 | ** libmail_u_convert(). Each call to libmail_u_convert() results in | |
482 | ** the output function being invoked, zero or more times, with the converted | |
483 | ** text. Finally, libmail_u_convert_deinit() stops the conversion and | |
484 | ** deallocates the conversion handle. | |
485 | ** | |
486 | ** Internal buffering takes place. libmail_u_convert_deinit() may result | |
487 | ** in the output function being called one or more times, to receive the final | |
488 | ** part of the converted character stream. | |
489 | ** | |
490 | ** The output function should return 0. A non-0 value causes | |
491 | ** libmail_u_convert() and/or libmail_u_convert_deinit() returning | |
492 | ** non-0. | |
493 | */ | |
494 | ||
495 | struct libmail_u_convert_hdr; | |
496 | ||
497 | typedef struct libmail_u_convert_hdr *libmail_u_convert_handle_t; | |
498 | ||
499 | /* | |
500 | ** libmail_u_convert_init() returns a non-NULL handle for the requested | |
501 | ** conversion, or NULL if the requested conversion is not available. | |
502 | */ | |
503 | ||
504 | libmail_u_convert_handle_t | |
505 | libmail_u_convert_init(/* Convert from this chset */ | |
506 | const char *src_chset, | |
507 | ||
508 | /* Convert to this chset */ | |
509 | const char *dst_chset, | |
510 | ||
511 | /* The output function */ | |
512 | ||
513 | int (*output_func)(const char *, size_t, void *), | |
514 | ||
515 | /* Passthrough arg */ | |
516 | void *convert_arg); | |
517 | ||
518 | /* | |
519 | ** Repeatedly pass the character text to convert to libmail_u_convert(). | |
520 | ** | |
521 | ** Returns non-0 if the output function returned non-0, or 0 if all invocations | |
522 | ** of the output function returned 0. | |
523 | */ | |
524 | ||
525 | int libmail_u_convert(/* The conversion handle */ | |
526 | libmail_u_convert_handle_t handle, | |
527 | ||
528 | /* Text to convert */ | |
529 | const char *text, | |
530 | ||
531 | /* Number of bytes to convert */ | |
532 | size_t cnt); | |
533 | ||
534 | /* | |
535 | ** Finish character set conversion. The handle gets deallocated. | |
536 | ** | |
537 | ** May still result in one or more invocations of the output function. | |
538 | ** Returns non-zero if any previous invocation of the output function returned | |
539 | ** non-zero (this includes any invocations of the output function resulting | |
540 | ** from this call, or prior libmail_u_convert() calls), or 0 if all | |
541 | ** invocations of the output function returned 0. | |
542 | ** | |
543 | ** If the errptr is not NULL, *errptr is set to non-zero if there were any | |
544 | ** conversion errors -- if there was any text that could not be converted to | |
545 | ** the destination character text. | |
546 | */ | |
547 | ||
548 | int libmail_u_convert_deinit(libmail_u_convert_handle_t handle, | |
549 | int *errptr); | |
550 | ||
551 | ||
552 | /* | |
553 | ** Specialization: save converted character text in a buffer. | |
554 | ** | |
555 | ** Implementation: call libmail_u_convert_tocbuf_init() instead of | |
556 | ** libmail_u_convert_init(), then call libmail_u_convert() and | |
557 | ** libmail_u_convert_deinit(), as usual. | |
558 | ** | |
559 | ** If libmail_u_convert_deinit() returns 0, *cbufptr_ret gets initialized to a | |
560 | ** malloc()ed buffer, and the number of converted characters, the size of the | |
561 | ** malloc()ed buffer, are placed into *csize_ret arguments, that were passed | |
562 | ** to libmail_u_convert_tou_init(). | |
563 | ** | |
564 | ** Note: if the converted string is an empty string, *cbufsize_ret is set to 0, | |
565 | ** but *cbufptr_ptr still gets initialized (to a dummy malloced buffer). | |
566 | ** | |
567 | ** The optional nullterminate places a trailing \0 character after the | |
568 | ** converted string (this is included in *cbufsize_ret). | |
569 | */ | |
570 | ||
571 | libmail_u_convert_handle_t | |
572 | libmail_u_convert_tocbuf_init(/* Convert from this chset */ | |
573 | const char *src_chset, | |
574 | ||
575 | /* Convert to this chset */ | |
576 | const char *dst_chset, | |
577 | ||
578 | /* malloced buffer */ | |
579 | char **cbufptr_ret, | |
580 | ||
581 | /* size of the malloced buffer */ | |
582 | size_t *cbufsize_ret, | |
583 | ||
584 | /* null terminate the resulting string */ | |
585 | int nullterminate | |
586 | ); | |
587 | ||
588 | ||
589 | /* | |
590 | ** Specialization: convert some character text to a unicode_char array. | |
591 | ** | |
592 | ** This is like libmail_u_convert_tocbuf_init(), but converts to a unicode_char | |
593 | ** array. | |
594 | ** | |
595 | ** The returned *ucsize_ret is initialized with the number of unicode_chars, | |
596 | ** rather than the byte count. | |
597 | ** | |
598 | ** In all other ways, this function behaves identically to | |
599 | ** libmail_u_convert_tocbuf_init(). | |
600 | */ | |
601 | ||
602 | libmail_u_convert_handle_t | |
603 | libmail_u_convert_tou_init(/* Convert from this chset */ | |
604 | const char *src_chset, | |
605 | ||
606 | /* malloc()ed buffer pointer, on exit. */ | |
607 | unicode_char **ucptr_ret, | |
608 | ||
609 | /* size of the malloc()ed buffer, upon exit */ | |
610 | size_t *ucsize_ret, | |
611 | ||
612 | /* If true, terminate with U+0x0000, for convenience */ | |
613 | int nullterminate | |
614 | ); | |
615 | ||
616 | /* | |
617 | ** Specialization: convert a unicode_char array to some character text. | |
618 | ** | |
619 | ** This is the opposite of libmail_u_convert_tou_init(). Call this to | |
620 | ** initialize the conversion handle, then use libmail_u_convert_uc() | |
621 | ** instead of libmail_u_convert. | |
622 | */ | |
623 | ||
624 | libmail_u_convert_handle_t | |
625 | libmail_u_convert_fromu_init(/* Convert to this chset */ | |
626 | const char *dst_chset, | |
627 | ||
628 | /* malloc()ed buffer pointer, on exit. */ | |
629 | char **cbufptr_ret, | |
630 | ||
631 | /* size of the malloc()ed buffer, upon exit */ | |
632 | size_t *cbufsize_ret, | |
633 | ||
634 | /* If true, terminate with U+0x0000, for convenience */ | |
635 | int nullterminate | |
636 | ); | |
637 | ||
638 | int libmail_u_convert_uc(/* The conversion handle */ | |
639 | libmail_u_convert_handle_t handle, | |
640 | ||
641 | /* Text to convert */ | |
642 | const unicode_char *text, | |
643 | ||
644 | /* Number of bytes to convert */ | |
645 | size_t cnt); | |
646 | ||
647 | /* | |
648 | ** Initialize conversion to UTF-8. | |
649 | ** | |
650 | ** This is a wrapper for libmail_u_convert_tocbuf_init() that specifies the | |
651 | ** destination charset as UTF-8. | |
652 | */ | |
653 | ||
654 | libmail_u_convert_handle_t | |
655 | libmail_u_convert_tocbuf_toutf8_init(const char *src_chset, | |
656 | char **cbufptr_ret, | |
657 | size_t *cbufsize_ret, | |
658 | int nullterminate); | |
659 | ||
660 | /* | |
661 | ** Initialize conversion from UTF-8. | |
662 | ** | |
663 | ** This is a wrapper for libmail_u_convert_tocbuf_init() that specifies the | |
664 | ** source charset as UTF-8. | |
665 | */ | |
666 | ||
667 | libmail_u_convert_handle_t | |
668 | libmail_u_convert_tocbuf_fromutf8_init(const char *dst_chset, | |
669 | char **cbufptr_ret, | |
670 | size_t *cbufsize_ret, | |
671 | int nullterminate); | |
672 | ||
673 | /* | |
674 | ** Convert a character string to UTF-8. | |
675 | ** | |
676 | ** Returns a malloc-ed buffer holding the UTF-8 string, or NULL if an | |
677 | ** error occured. | |
678 | */ | |
679 | char *libmail_u_convert_toutf8(/* Text to convert to UTF-8 */ | |
680 | const char *text, | |
681 | ||
682 | /* Character set to convert to UTF-8 */ | |
683 | const char *charset, | |
684 | ||
685 | /* | |
686 | ** If non-NULL, and a non-NULL pointer is | |
687 | ** returned, *error is set to non-zero if | |
688 | ** a character conversion error has occured. | |
689 | */ | |
690 | int *error); | |
691 | ||
692 | /* | |
693 | ** Convert UTF-8 text to another character set. | |
694 | ** | |
695 | ** Returns a malloc-ed buffer holding the string converted to the specified | |
696 | ** character set, or NULL if an error occured. | |
697 | */ | |
698 | ||
699 | char *libmail_u_convert_fromutf8(/* A UTF-8 string */ | |
700 | const char *text, | |
701 | ||
702 | /* | |
703 | ** Convert the UTF-8 string to this character | |
704 | ** set. | |
705 | */ | |
706 | ||
707 | const char *charset, | |
708 | ||
709 | /* | |
710 | ** If non-NULL, and a non-NULL pointer is | |
711 | ** returned, *error is set to non-zero if | |
712 | ** a character conversion error has occured. | |
713 | */ | |
714 | int *error); | |
715 | ||
716 | /* | |
717 | ** Convert one charset to another charset, placing the result in a malloc-ed | |
718 | ** buffer. | |
719 | ** | |
720 | ** Returns a malloc-ed buffer holding the string converted to the specified | |
721 | ** character set, or NULL if an error occured. | |
722 | */ | |
723 | ||
724 | char *libmail_u_convert_tobuf(/* A string to convert */ | |
725 | const char *text, | |
726 | ||
727 | /* | |
728 | ** String's charset. | |
729 | */ | |
730 | ||
731 | const char *charset, | |
732 | ||
733 | /* | |
734 | ** Destination charset | |
735 | */ | |
736 | const char *dstcharset, | |
737 | ||
738 | /* | |
739 | ** If non-NULL, and a non-NULL pointer is | |
740 | ** returned, *error is set to non-zero if | |
741 | ** a character conversion error has occured. | |
742 | */ | |
743 | int *error); | |
744 | ||
745 | /* | |
746 | ** Convenience function: call libmail_u_convert_tou_init(), feed the | |
747 | ** character string through libmail_u_convert(), then call | |
748 | ** libmail_u_convert_deinit(). | |
749 | ** | |
750 | ** If this function returns 0, *uc and *ucsize is set to a malloced buffer+size | |
751 | ** holding the unicode char array. | |
752 | */ | |
753 | ||
754 | int libmail_u_convert_tou_tobuf(/* Character text to convert */ | |
755 | const char *text, | |
756 | ||
757 | /* Number of characters */ | |
758 | size_t text_l, | |
759 | ||
760 | /* text's charset */ | |
761 | const char *charset, | |
762 | ||
763 | /* | |
764 | ** If this function returns 0, this gets | |
765 | ** initialized | |
766 | */ | |
767 | unicode_char **uc, | |
768 | ||
769 | /* | |
770 | ** Size of the allocated buffer | |
771 | */ | |
772 | size_t *ucsize, | |
773 | ||
774 | /* | |
775 | ** If not null and this function returns 0, | |
776 | ** this is set to non-0 if there | |
777 | ** was a conversion error (but the output | |
778 | ** buffer gets still allocated and | |
779 | ** initialized) | |
780 | */ | |
781 | int *err); | |
782 | ||
783 | /* | |
784 | ** Convenience function: call libmail_u_convert_fromu_init(), feed the | |
785 | ** unicode_array through libmail_u_convert_uc(), then call | |
786 | ** libmail_u_convert_deinit(). | |
787 | ** | |
788 | ** If this function returns 0, *uc and *ucsize is set to a malloced buffer+size | |
789 | ** holding the converted character string | |
790 | */ | |
791 | ||
792 | int libmail_u_convert_fromu_tobuf(/* Unicode array to convert to a char str */ | |
793 | const unicode_char *utext, | |
794 | ||
795 | /* | |
796 | ** Size of the unicode array. | |
797 | ** If this is (size_t)-1, utext is a | |
798 | ** 0-terminated array. | |
799 | */ | |
800 | size_t utext_l, | |
801 | ||
802 | /* | |
803 | ** Convert the unicode array to this charset. | |
804 | */ | |
805 | const char *charset, | |
806 | ||
807 | /* | |
808 | ** If libmail_u_convert_fromu_tobuf() | |
809 | ** returns 0, this is initialized to a | |
810 | ** malloced buffer with a 0-terminated | |
811 | ** string is kept. | |
812 | */ | |
813 | char **c, | |
814 | ||
815 | /* | |
816 | ** Size of the initialized array, including | |
817 | ** the 0-terminator. | |
818 | */ | |
819 | size_t *csize, | |
820 | ||
821 | /* | |
822 | ** If libmail_u_convert_fromu_tobuf() | |
823 | ** returns 0 and this is not NULL, | |
824 | ** *err is set to non-0 if there was a | |
825 | ** conversion error to the requested | |
826 | ** character set. | |
827 | */ | |
828 | int *err); | |
829 | ||
830 | /* | |
831 | ** Convenience function: convert a string in a given character set | |
832 | ** to/from uppercase, lowercase, or something else. | |
833 | ** | |
834 | ** This is done by calling libmail_u_convert_tou_tobuf() first, | |
835 | ** applying the title_func and char_func, then using | |
836 | ** libmail_u_convert_fromu_tobuf(). | |
837 | ** | |
838 | ** A NULL return indicates that the requested conversion cannot be performed. | |
839 | */ | |
840 | ||
841 | char *libmail_u_convert_tocase( /* String to convert */ | |
842 | const char *str, | |
843 | ||
844 | /* String's character set */ | |
845 | ||
846 | const char *charset, | |
847 | ||
848 | /* | |
849 | ** Conversion of the first character in | |
850 | ** str: unicode_uc, unicode_lc, or unicode_tc: | |
851 | */ | |
852 | ||
853 | unicode_char (*first_char_func)(unicode_char), | |
854 | ||
855 | /* | |
856 | ** Conversion of the second and the remaining | |
857 | ** character in str. If NULL, same as | |
858 | ** first_char_func. | |
859 | */ | |
860 | unicode_char (*char_func)(unicode_char)); | |
861 | ||
862 | ||
863 | ||
864 | /* Either UCS-4BE or UCS-4LE, matching the native unicode_char endianness */ | |
865 | ||
866 | extern const char libmail_u_ucs4_native[]; | |
867 | ||
868 | /* Either UCS-2BE or UCS-2LE, matching the native unicode_char endianness */ | |
869 | ||
870 | extern const char libmail_u_ucs2_native[]; | |
871 | ||
872 | /* | |
873 | ** Modified-UTF7 encoding used for IMAP folder names. Pass it for a charset | |
874 | ** parameter. | |
875 | ** | |
876 | ** This can be followed by a " " and up to 15 characters to be escaped in | |
877 | ** addition to unicode chars. | |
878 | */ | |
879 | ||
880 | #define unicode_x_imap_modutf7 "x-imap-modutf7" | |
881 | ||
882 | #if 0 | |
883 | { | |
884 | #endif | |
885 | ||
886 | #ifdef __cplusplus | |
887 | } | |
888 | ||
889 | extern size_t unicode_wcwidth(const std::vector<unicode_char> &uc); | |
890 | ||
891 | namespace mail { | |
892 | ||
893 | /* | |
894 | ** Interface to iconv. | |
895 | ** | |
896 | ** Subclass converted(). Invoke begin(), then operator(), repeatedly, | |
897 | ** then end(). | |
898 | ** | |
899 | ** converted() receives the converted text. | |
900 | */ | |
901 | ||
902 | class iconvert { | |
903 | ||
904 | libmail_u_convert_handle_t handle; | |
905 | ||
906 | public: | |
907 | iconvert(); | |
908 | virtual ~iconvert(); | |
909 | ||
910 | /* Start conversion. | |
911 | ** Returns false if the requested conversion cannot be done. | |
912 | **/ | |
913 | ||
914 | bool begin(/* Convert from */ | |
915 | const std::string &src_chset, | |
916 | ||
917 | /* Convert to */ | |
918 | const std::string &dst_chset); | |
919 | ||
920 | /* Feed iconv(3). Returns false if the conversion was aborted. | |
921 | */ | |
922 | ||
923 | bool operator()(const char *, size_t); | |
924 | ||
925 | bool operator()(const unicode_char *, size_t); | |
926 | ||
927 | /* | |
928 | ** Get the results here. If the subclass returns a non-0 | |
929 | ** value, the conversion is aborted. | |
930 | */ | |
931 | ||
932 | virtual int converted(const char *, size_t); | |
933 | ||
934 | /* | |
935 | ** End of conversion. | |
936 | ** | |
937 | ** Returns true if all calls to converted() returned 0, | |
938 | ** false if the conversion was aborted. | |
939 | ** | |
940 | ** errflag is set to true if there was a character that could | |
941 | ** not be converted, and passed to converted(). | |
942 | */ | |
943 | ||
944 | bool end(bool &errflag) | |
945 | { | |
946 | return end(&errflag); | |
947 | } | |
948 | ||
949 | bool end() | |
950 | { | |
951 | return end(NULL); | |
952 | } | |
953 | ||
954 | /* Convert between two different charsets */ | |
955 | ||
956 | static std::string convert(const std::string &text, | |
957 | const std::string &charset, | |
958 | const std::string &dstcharset, | |
959 | bool &errflag); | |
960 | ||
961 | /* Convert between two different charsets */ | |
962 | ||
963 | static std::string convert(const std::string &text, | |
964 | const std::string &charset, | |
965 | const std::string &dstcharset) | |
966 | { | |
967 | bool dummy; | |
968 | ||
969 | return convert(text, charset, dstcharset, dummy); | |
970 | } | |
971 | ||
972 | /* Convert from unicode to a charset */ | |
973 | ||
974 | static std::string convert(const std::vector<unicode_char> &uc, | |
975 | const std::string &dstcharset, | |
976 | bool &errflag); | |
977 | ||
978 | /* Convert from unicode to a charset */ | |
979 | ||
980 | static std::string convert(const std::vector<unicode_char> &uc, | |
981 | const std::string &dstcharset) | |
982 | { | |
983 | bool dummy; | |
984 | ||
985 | return convert(uc, dstcharset, dummy); | |
986 | } | |
987 | ||
988 | /* Convert charset to unicode */ | |
989 | ||
990 | static bool convert(const std::string &text, | |
991 | const std::string &charset, | |
992 | std::vector<unicode_char> &uc); | |
993 | ||
994 | ||
995 | /* Convert to upper/lower/title case */ | |
996 | ||
997 | static std::string | |
998 | convert_tocase(/* Text string */ | |
999 | const std::string &text, | |
1000 | ||
1001 | /* Its charset */ | |
1002 | const std::string &charset, | |
1003 | ||
1004 | /* First character: unicode_uc, unicode_lc, or unicode_tc */ | |
1005 | unicode_char (*first_char_func)(unicode_char), | |
1006 | ||
1007 | /* If not NULL, second and subsequent chars */ | |
1008 | unicode_char (*char_func)(unicode_char) | |
1009 | =NULL) | |
1010 | { | |
1011 | bool dummy; | |
1012 | ||
1013 | return convert_tocase(text, charset, dummy, | |
1014 | first_char_func, | |
1015 | char_func); | |
1016 | } | |
1017 | ||
1018 | /* Convert to upper/lower/title case */ | |
1019 | ||
1020 | static std::string | |
1021 | convert_tocase(/* Text string */ | |
1022 | const std::string &text, | |
1023 | ||
1024 | /* Its charset */ | |
1025 | const std::string &charset, | |
1026 | ||
1027 | /* Set if there's a conversion error */ | |
1028 | bool &err, | |
1029 | ||
1030 | /* First character: unicode_uc, unicode_lc, or unicode_tc */ | |
1031 | unicode_char (*first_char_func)(unicode_char), | |
1032 | ||
1033 | /* If not NULL, second and subsequent chars */ | |
1034 | unicode_char (*char_func)(unicode_char) | |
1035 | =NULL); | |
1036 | private: | |
1037 | bool end(bool *); | |
1038 | ||
1039 | public: | |
1040 | class tou; | |
1041 | class fromu; | |
1042 | }; | |
1043 | ||
1044 | /* Convert output of iconvert to unicode_chars. */ | |
1045 | ||
1046 | class iconvert::tou : public iconvert { | |
1047 | ||
1048 | public: | |
1049 | bool begin(const std::string &chset); | |
1050 | ||
1051 | virtual int converted(const unicode_char *, size_t); | |
1052 | ||
1053 | using iconvert::operator(); | |
1054 | private: | |
1055 | int converted(const char *ptr, size_t cnt); | |
1056 | ||
1057 | public: | |
1058 | template<typename iter_t> class to_iter_class; | |
1059 | ||
1060 | template<typename input_iter_t, | |
1061 | typename output_iter_t> | |
1062 | static output_iter_t convert(input_iter_t from_iter, | |
1063 | input_iter_t to_iter, | |
1064 | const std::string &chset, | |
1065 | output_iter_t out_iter); | |
1066 | ||
1067 | template<typename input_iter_t> | |
1068 | static void convert(input_iter_t from_iter, | |
1069 | input_iter_t to_iter, | |
1070 | const std::string &chset, | |
1071 | std::vector<unicode_char> &out_buf) | |
1072 | { | |
1073 | out_buf.clear(); | |
1074 | std::back_insert_iterator<std::vector<unicode_char> > | |
1075 | insert_iter(out_buf); | |
1076 | ||
1077 | convert(from_iter, to_iter, chset, insert_iter); | |
1078 | } | |
1079 | ||
1080 | static void convert(const std::string &str, | |
1081 | const std::string &chset, | |
1082 | std::vector<unicode_char> &out_buf); | |
1083 | }; | |
1084 | ||
1085 | /* Helper class that saves unicode output into an output iterator */ | |
1086 | ||
1087 | template<typename iter_t> | |
1088 | class iconvert::tou::to_iter_class : public iconvert::tou { | |
1089 | ||
1090 | iter_t iter; | |
1091 | public: | |
1092 | ||
1093 | to_iter_class(iter_t iterValue) | |
1094 | : iter(iterValue) {} | |
1095 | ||
1096 | using tou::operator(); | |
1097 | ||
1098 | operator iter_t() const { return iter; } | |
1099 | ||
1100 | private: | |
1101 | int converted(const unicode_char *ptr, size_t cnt) | |
1102 | { | |
1103 | while (cnt) | |
1104 | { | |
1105 | *iter=*ptr; | |
1106 | ||
1107 | ++iter; | |
1108 | ++ptr; | |
1109 | --cnt; | |
1110 | } | |
1111 | return 0; | |
1112 | } | |
1113 | }; | |
1114 | ||
1115 | template<typename input_iter_t, | |
1116 | typename output_iter_t> | |
1117 | output_iter_t iconvert::tou::convert(input_iter_t from_iter, | |
1118 | input_iter_t to_iter, | |
1119 | const std::string &chset, | |
1120 | output_iter_t out_iter) | |
1121 | { | |
1122 | class to_iter_class<output_iter_t> out(out_iter); | |
1123 | ||
1124 | if (!out.begin(chset)) | |
1125 | return out; | |
1126 | ||
1127 | std::vector<char> string; | |
1128 | ||
1129 | while (from_iter != to_iter) | |
1130 | { | |
1131 | string.push_back(*from_iter++); | |
1132 | ||
1133 | if (string.size() > 31) | |
1134 | { | |
1135 | out(&string[0], string.size()); | |
1136 | string.clear(); | |
1137 | } | |
1138 | } | |
1139 | ||
1140 | if (string.size() > 0) | |
1141 | out(&string[0], string.size()); | |
1142 | ||
1143 | out.end(); | |
1144 | return out; | |
1145 | } | |
1146 | ||
1147 | /* Convert output of iconvert from unicode_chars. */ | |
1148 | ||
1149 | class iconvert::fromu : public iconvert { | |
1150 | ||
1151 | public: | |
1152 | bool begin(const std::string &chset); | |
1153 | ||
1154 | using iconvert::operator(); | |
1155 | ||
1156 | template<typename iter_t> class to_iter_class; | |
1157 | ||
1158 | template<typename input_iter_t, | |
1159 | typename output_iter_t> | |
1160 | static output_iter_t convert(input_iter_t from_iter, | |
1161 | input_iter_t to_iter, | |
1162 | const std::string &chset, | |
1163 | output_iter_t out_iter); | |
1164 | ||
1165 | template<typename input_iter_t> | |
1166 | static void convert(input_iter_t from_iter, | |
1167 | input_iter_t to_iter, | |
1168 | const std::string &chset, | |
1169 | std::string &out_buf) | |
1170 | { | |
1171 | out_buf=""; | |
1172 | std::back_insert_iterator<std::string> | |
1173 | insert_iter(out_buf); | |
1174 | ||
1175 | convert(from_iter, to_iter, chset, insert_iter); | |
1176 | } | |
1177 | ||
1178 | static void convert(const std::vector<unicode_char> &ubuf, | |
1179 | const std::string &chset, | |
1180 | std::string &out_buf); | |
1181 | ||
1182 | static std::string convert(const std::vector<unicode_char> | |
1183 | &ubuf, | |
1184 | const std::string &chset); | |
1185 | }; | |
1186 | ||
1187 | /* Helper class that saves unicode output into an output iterator */ | |
1188 | ||
1189 | template<typename iter_t> | |
1190 | class iconvert::fromu::to_iter_class : public iconvert::fromu { | |
1191 | ||
1192 | iter_t iter; | |
1193 | public: | |
1194 | ||
1195 | to_iter_class(iter_t iterValue) | |
1196 | : iter(iterValue) {} | |
1197 | ||
1198 | using fromu::operator(); | |
1199 | ||
1200 | operator iter_t() const { return iter; } | |
1201 | ||
1202 | private: | |
1203 | int converted(const char *ptr, size_t cnt) | |
1204 | { | |
1205 | while (cnt) | |
1206 | { | |
1207 | *iter=*ptr; | |
1208 | ||
1209 | ++iter; | |
1210 | ++ptr; | |
1211 | --cnt; | |
1212 | } | |
1213 | return 0; | |
1214 | } | |
1215 | }; | |
1216 | ||
1217 | template<typename input_iter_t, | |
1218 | typename output_iter_t> | |
1219 | output_iter_t iconvert::fromu::convert(input_iter_t from_iter, | |
1220 | input_iter_t to_iter, | |
1221 | const std::string &chset, | |
1222 | output_iter_t out_iter) | |
1223 | { | |
1224 | class to_iter_class<output_iter_t> out(out_iter); | |
1225 | ||
1226 | if (!out.begin(chset)) | |
1227 | return out; | |
1228 | ||
1229 | std::vector<unicode_char> string; | |
1230 | ||
1231 | while (from_iter != to_iter) | |
1232 | { | |
1233 | string.push_back(*from_iter++); | |
1234 | ||
1235 | if (string.size() > 31) | |
1236 | { | |
1237 | out(&string[0], string.size()); | |
1238 | string.clear(); | |
1239 | } | |
1240 | } | |
1241 | ||
1242 | if (string.size() > 0) | |
1243 | out(&string[0], string.size()); | |
1244 | ||
1245 | out.end(); | |
1246 | return out; | |
1247 | } | |
1248 | ||
1249 | /* | |
1250 | ** Unicode linebreaking algorithm, tr14. | |
1251 | */ | |
1252 | ||
1253 | extern "C" int linebreak_trampoline(int value, void *ptr); | |
1254 | extern "C" int linebreakc_trampoline(int value, unicode_char ch, | |
1255 | void *ptr); | |
1256 | ||
1257 | /* | |
1258 | ** Subclass linebreak_callback_base, implement operator()(int). | |
1259 | ** | |
1260 | ** Use operator<< or operator()(iterator, iterator) to feed | |
1261 | ** unicode_chars into the linebreaking algorithm. The subclass receives | |
1262 | ** UNICODE_LB values, as they become available. | |
1263 | */ | |
1264 | ||
1265 | class linebreak_callback_base { | |
1266 | ||
1267 | unicode_lb_info_t handle; | |
1268 | ||
1269 | int opts; | |
1270 | ||
1271 | linebreak_callback_base(const linebreak_callback_base &); | |
1272 | /* NOT IMPLEMENTED */ | |
1273 | ||
1274 | linebreak_callback_base &operator==(const | |
1275 | linebreak_callback_base &); | |
1276 | /* NOT IMPLEMENTED */ | |
1277 | ||
1278 | public: | |
1279 | linebreak_callback_base(); | |
1280 | virtual ~linebreak_callback_base(); | |
1281 | ||
1282 | void finish(); | |
1283 | ||
1284 | void set_opts(int opts); | |
1285 | ||
1286 | friend int linebreak_trampoline(int, void *); | |
1287 | ||
1288 | linebreak_callback_base &operator<<(unicode_char uc); | |
1289 | ||
1290 | template<typename iter_type> | |
1291 | linebreak_callback_base &operator()(iter_type beg_iter, | |
1292 | iter_type end_iter) | |
1293 | { | |
1294 | while (beg_iter != end_iter) | |
1295 | operator<<(*beg_iter++); | |
1296 | return *this; | |
1297 | } | |
1298 | ||
1299 | linebreak_callback_base &operator<<(const | |
1300 | std::vector<unicode_char> | |
1301 | &vec) | |
1302 | { | |
1303 | return operator()(vec.begin(), vec.end()); | |
1304 | } | |
1305 | private: | |
1306 | virtual int operator()(int); | |
1307 | }; | |
1308 | ||
1309 | class linebreak_callback_save_buf : public linebreak_callback_base { | |
1310 | ||
1311 | public: | |
1312 | std::list<int> lb_buf; | |
1313 | ||
1314 | linebreak_callback_save_buf(); | |
1315 | ~linebreak_callback_save_buf(); | |
1316 | ||
1317 | private: | |
1318 | int operator()(int value); | |
1319 | }; | |
1320 | ||
1321 | /* | |
1322 | ** Convert an input iterator sequence over unicode_chars into | |
1323 | ** an input iterator sequence over linebreak values. | |
1324 | */ | |
1325 | ||
1326 | template<typename input_t> class linebreak_iter | |
1327 | : public std::iterator<std::input_iterator_tag, int, void> | |
1328 | { | |
1329 | mutable input_t iter_value, end_iter_value; | |
1330 | ||
1331 | mutable linebreak_callback_save_buf *buf; | |
1332 | ||
1333 | void fill() const | |
1334 | { | |
1335 | if (buf == NULL) | |
1336 | return; | |
1337 | ||
1338 | while (buf->lb_buf.empty()) | |
1339 | { | |
1340 | if (iter_value == end_iter_value) | |
1341 | { | |
1342 | buf->finish(); | |
1343 | if (buf->lb_buf.empty()) | |
1344 | { | |
1345 | delete buf; | |
1346 | buf=NULL; | |
1347 | } | |
1348 | break; | |
1349 | } | |
1350 | ||
1351 | buf->operator<<(*iter_value++); | |
1352 | } | |
1353 | } | |
1354 | ||
1355 | mutable value_type bufvalue; | |
1356 | ||
1357 | public: | |
1358 | linebreak_iter(const input_t &iter_valueArg, | |
1359 | const input_t &iter_endvalueArg) | |
1360 | : iter_value(iter_valueArg), | |
1361 | end_iter_value(iter_endvalueArg), | |
1362 | buf(new linebreak_callback_save_buf) | |
1363 | { | |
1364 | } | |
1365 | ||
1366 | linebreak_iter() : buf(NULL) | |
1367 | { | |
1368 | } | |
1369 | ||
1370 | void set_opts(int opts) | |
1371 | { | |
1372 | if (buf) | |
1373 | buf->set_opts(opts); | |
1374 | } | |
1375 | ||
1376 | ~linebreak_iter() | |
1377 | { | |
1378 | if (buf) | |
1379 | delete buf; | |
1380 | } | |
1381 | ||
1382 | linebreak_iter(const linebreak_iter<input_t> &v) | |
1383 | : buf(NULL) | |
1384 | { | |
1385 | operator=(v); | |
1386 | } | |
1387 | ||
1388 | linebreak_iter<input_t> &operator=(const | |
1389 | linebreak_iter<input_t> &v) | |
1390 | { | |
1391 | if (buf) | |
1392 | delete buf; | |
1393 | buf=v.buf; | |
1394 | iter_value=v.iter_value; | |
1395 | end_iter_value=v.end_iter_value; | |
1396 | v.buf=NULL; | |
1397 | return *this; | |
1398 | } | |
1399 | ||
1400 | bool operator==(const linebreak_iter<input_t> &v) const | |
1401 | { | |
1402 | fill(); | |
1403 | v.fill(); | |
1404 | ||
1405 | return buf == NULL && v.buf == NULL; | |
1406 | } | |
1407 | ||
1408 | bool operator!=(const linebreak_iter<input_t> &v) const | |
1409 | { | |
1410 | return !operator==(v); | |
1411 | } | |
1412 | ||
1413 | value_type operator*() const | |
1414 | { | |
1415 | fill(); | |
1416 | return buf == NULL ? UNICODE_LB_MANDATORY: | |
1417 | buf->lb_buf.front(); | |
1418 | } | |
1419 | ||
1420 | linebreak_iter<input_t> &operator++() | |
1421 | { | |
1422 | bufvalue=operator*(); | |
1423 | ||
1424 | if (buf) | |
1425 | buf->lb_buf.pop_front(); | |
1426 | return *this; | |
1427 | } | |
1428 | ||
1429 | const value_type *operator++(int) | |
1430 | { | |
1431 | operator++(); | |
1432 | return &bufvalue; | |
1433 | } | |
1434 | }; | |
1435 | ||
1436 | /* | |
1437 | ** Like linebreak_callback_base, except the subclass receives both | |
1438 | ** the linebreaking value, and the unicode character. | |
1439 | */ | |
1440 | ||
1441 | class linebreakc_callback_base { | |
1442 | ||
1443 | unicode_lbc_info_t handle; | |
1444 | ||
1445 | int opts; | |
1446 | ||
1447 | linebreakc_callback_base(const linebreakc_callback_base &); | |
1448 | /* NOT IMPLEMENTED */ | |
1449 | ||
1450 | linebreakc_callback_base &operator==(const | |
1451 | linebreakc_callback_base | |
1452 | &); | |
1453 | /* NOT IMPLEMENTED */ | |
1454 | ||
1455 | ||
1456 | public: | |
1457 | linebreakc_callback_base(); | |
1458 | virtual ~linebreakc_callback_base(); | |
1459 | ||
1460 | void finish(); | |
1461 | ||
1462 | void set_opts(int opts); | |
1463 | ||
1464 | friend int linebreakc_trampoline(int, unicode_char, void *); | |
1465 | ||
1466 | linebreakc_callback_base &operator<<(unicode_char uc); | |
1467 | ||
1468 | template<typename iter_type> | |
1469 | linebreakc_callback_base &operator()(iter_type beg_iter, | |
1470 | iter_type end_iter) | |
1471 | { | |
1472 | while (beg_iter != end_iter) | |
1473 | operator<<(*beg_iter++); | |
1474 | return *this; | |
1475 | } | |
1476 | ||
1477 | linebreakc_callback_base &operator<<(const | |
1478 | std::vector<unicode_char> | |
1479 | &vec) | |
1480 | { | |
1481 | return operator()(vec.begin(), vec.end()); | |
1482 | } | |
1483 | private: | |
1484 | virtual int operator()(int, unicode_char); | |
1485 | }; | |
1486 | ||
1487 | class linebreakc_callback_save_buf : public linebreakc_callback_base { | |
1488 | ||
1489 | public: | |
1490 | std::list<std::pair<int, unicode_char> > lb_buf; | |
1491 | ||
1492 | linebreakc_callback_save_buf(); | |
1493 | ~linebreakc_callback_save_buf(); | |
1494 | ||
1495 | private: | |
1496 | int operator()(int, unicode_char); | |
1497 | }; | |
1498 | ||
1499 | ||
1500 | /* | |
1501 | ** Convert an input iterator sequence over unicode_chars into | |
1502 | ** an input iterator sequence over std::pair<int, unicode_char>, | |
1503 | ** the original unicode character, and the linebreaking value before | |
1504 | ** the character. | |
1505 | */ | |
1506 | ||
1507 | template<typename input_t> class linebreakc_iter | |
1508 | : public std::iterator<std::input_iterator_tag, | |
1509 | std::pair<int, unicode_char>, void> | |
1510 | { | |
1511 | mutable input_t iter_value, end_iter_value; | |
1512 | ||
1513 | mutable linebreakc_callback_save_buf *buf; | |
1514 | ||
1515 | void fill() const | |
1516 | { | |
1517 | if (buf == NULL) | |
1518 | return; | |
1519 | ||
1520 | while (buf->lb_buf.empty()) | |
1521 | { | |
1522 | if (iter_value == end_iter_value) | |
1523 | { | |
1524 | buf->finish(); | |
1525 | if (buf->lb_buf.empty()) | |
1526 | { | |
1527 | delete buf; | |
1528 | buf=NULL; | |
1529 | } | |
1530 | break; | |
1531 | } | |
1532 | ||
1533 | buf->operator<<(*iter_value); | |
1534 | ++iter_value; | |
1535 | } | |
1536 | } | |
1537 | ||
1538 | mutable value_type bufvalue; | |
1539 | ||
1540 | public: | |
1541 | linebreakc_iter(const input_t &iter_valueArg, | |
1542 | const input_t &iter_endvalueArg) | |
1543 | : iter_value(iter_valueArg), | |
1544 | end_iter_value(iter_endvalueArg), | |
1545 | buf(new linebreakc_callback_save_buf) | |
1546 | { | |
1547 | } | |
1548 | ||
1549 | linebreakc_iter() : buf(NULL) | |
1550 | { | |
1551 | } | |
1552 | ||
1553 | ~linebreakc_iter() | |
1554 | { | |
1555 | if (buf) | |
1556 | delete buf; | |
1557 | } | |
1558 | ||
1559 | linebreakc_iter(const linebreakc_iter<input_t> &v) | |
1560 | : buf(NULL) | |
1561 | { | |
1562 | operator=(v); | |
1563 | } | |
1564 | ||
1565 | linebreakc_iter<input_t> &operator=(const | |
1566 | linebreakc_iter<input_t> &v) | |
1567 | { | |
1568 | if (buf) | |
1569 | delete buf; | |
1570 | buf=v.buf; | |
1571 | iter_value=v.iter_value; | |
1572 | end_iter_value=v.end_iter_value; | |
1573 | v.buf=NULL; | |
1574 | return *this; | |
1575 | } | |
1576 | ||
1577 | bool operator==(const linebreakc_iter<input_t> &v) const | |
1578 | { | |
1579 | fill(); | |
1580 | v.fill(); | |
1581 | ||
1582 | return buf == NULL && v.buf == NULL; | |
1583 | } | |
1584 | ||
1585 | bool operator!=(const linebreakc_iter<input_t> &v) const | |
1586 | { | |
1587 | return !operator==(v); | |
1588 | } | |
1589 | ||
1590 | value_type operator*() const | |
1591 | { | |
1592 | fill(); | |
1593 | return buf == NULL ? | |
1594 | std::make_pair(UNICODE_LB_MANDATORY, | |
1595 | (unicode_char)0): | |
1596 | buf->lb_buf.front(); | |
1597 | } | |
1598 | ||
1599 | linebreakc_iter<input_t> &operator++() | |
1600 | { | |
1601 | bufvalue=operator*(); | |
1602 | ||
1603 | if (buf) | |
1604 | buf->lb_buf.pop_front(); | |
1605 | return *this; | |
1606 | } | |
1607 | ||
1608 | const value_type *operator++(int) | |
1609 | { | |
1610 | operator++(); | |
1611 | return &bufvalue; | |
1612 | } | |
1613 | }; | |
1614 | ||
1615 | ||
1616 | /* | |
1617 | ** Subclass wordbreak_callback_base, implement operator()(int). | |
1618 | ** | |
1619 | ** Use operator<< or operator()(iterator, iterator) to feed | |
1620 | ** unicode_chars into the wordbreaking algorithm. The subclass receives | |
1621 | ** word flags, as they become available. | |
1622 | */ | |
1623 | ||
1624 | extern "C" int wordbreak_trampoline(int value, void *ptr); | |
1625 | ||
1626 | class wordbreak_callback_base { | |
1627 | ||
1628 | unicode_wb_info_t handle; | |
1629 | ||
1630 | wordbreak_callback_base(const wordbreak_callback_base &); | |
1631 | /* NOT IMPLEMENTED */ | |
1632 | ||
1633 | wordbreak_callback_base &operator==(const | |
1634 | wordbreak_callback_base &); | |
1635 | /* NOT IMPLEMENTED */ | |
1636 | ||
1637 | public: | |
1638 | wordbreak_callback_base(); | |
1639 | virtual ~wordbreak_callback_base(); | |
1640 | ||
1641 | void finish(); | |
1642 | ||
1643 | friend int wordbreak_trampoline(int, void *); | |
1644 | ||
1645 | wordbreak_callback_base &operator<<(unicode_char uc); | |
1646 | ||
1647 | template<typename iter_type> | |
1648 | wordbreak_callback_base &operator()(iter_type beg_iter, | |
1649 | iter_type end_iter) | |
1650 | { | |
1651 | while (beg_iter != end_iter) | |
1652 | operator<<(*beg_iter++); | |
1653 | return *this; | |
1654 | } | |
1655 | ||
1656 | wordbreak_callback_base &operator<<(const | |
1657 | std::vector<unicode_char> | |
1658 | &vec) | |
1659 | { | |
1660 | return operator()(vec.begin(), vec.end()); | |
1661 | } | |
1662 | private: | |
1663 | virtual int operator()(bool); | |
1664 | }; | |
1665 | ||
1666 | /* | |
1667 | ** A C++ wrapper for unicode_wbscan. | |
1668 | */ | |
1669 | ||
1670 | class wordbreakscan { | |
1671 | ||
1672 | unicode_wbscan_info_t handle; | |
1673 | ||
1674 | wordbreakscan(const wordbreakscan &); | |
1675 | /* NOT IMPLEMENTED */ | |
1676 | ||
1677 | wordbreakscan &operator==(const wordbreakscan &); | |
1678 | /* NOT IMPLEMENTED */ | |
1679 | public: | |
1680 | ||
1681 | wordbreakscan(); | |
1682 | ~wordbreakscan(); | |
1683 | ||
1684 | bool operator<<(unicode_char uc); | |
1685 | ||
1686 | size_t finish(); | |
1687 | }; | |
1688 | ||
1689 | } | |
1690 | #endif | |
1691 | ||
1692 | #endif |