chiark / gitweb /
tests and a correction for grapheme cluster boundary detection
[disorder] / lib / charset.h
CommitLineData
460b9539 1/*
2 * This file is part of DisOrder.
3 * Copyright (C) 2004, 2005 Richard Kettlewell
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
18 * USA
19 */
20#ifndef CHARSET_H
21#define CHARSET_H
22
13affe66
RK
23struct dynstr;
24
460b9539 25/* Character encoding conversion routines */
26
13affe66
RK
27int one_ucs42utf8(uint32_t c, struct dynstr *d);
28
460b9539 29uint32_t *utf82ucs4(const char *mb);
30char *ucs42utf8(const uint32_t *u);
31char *mb2utf8(const char *mb);
32char *utf82mb(const char *utf8);
33/* various conversions, between multibyte strings (mb) in
34 * whatever the current encoding is, and UTF-8 strings (utf8). On
35 * error, a null pointer is returned and @errno@ set. */
36
37char *any2utf8(const char *from/*encoding*/,
38 const char *any/*string*/);
39/* arbitrary conversions from any null-free byte-based encoding that
40 * iconv knows about to UTF-8 */
41
42char *any2mb(const char *from/*encoding or 0*/,
43 const char *any/*string*/);
44/* Arbitrary conversions from any null-free byte-based encoding that
45 * iconv knows about to a multibyte string. If FROM is 0 then ANY is
46 * returned unchanged. */
47
48char *any2any(const char *from/*encoding or 0*/,
49 const char *to/*encoding to 0*/,
50 const char *any/*string*/);
51/* Arbitrary conversions between any null-free byte-based encodings
52 * that iconv knows. If FROM and TO are both 0 then ANY is returned
53 * unchanged. */
54
0e4472a0 55/** @brief Insist that @p s is not null
56 * @param s Pointer to check
57 * @return @p s
58 *
59 * Terminates the process if @p s is a null pointer.
60 */
460b9539 61static inline char *nullcheck(char *s) {
62 if(!s) exitfn(1); /* assume an error already reported */
63 return s;
64}
65
66int ucs4cmp(const uint32_t *a, const uint32_t *b);
67/* like strcmp */
68
61507e3c
RK
69const char *truncate_for_display(const char *s, long max);
70
460b9539 71#endif /* CHARSET_H */
72
73/*
74Local Variables:
75c-basic-offset:2
76comment-column:40
77End:
78*/