Sync usage with man page.
[netbsd-mini2440.git] / lib / libedit / chartype.h
bloba6a841ff134a0b6568a0d6e1f5d5733f5027a484
1 /* $NetBSD: chartype.h,v 1.3 2009/12/31 18:32:37 christos Exp $ */
3 /*-
4 * Copyright (c) 2009 The NetBSD Foundation, Inc.
5 * All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. All advertising materials mentioning features or use of this software
16 * must display the following acknowledgement:
17 * This product includes software developed by the NetBSD
18 * Foundation, Inc. and its contributors.
19 * 4. Neither the name of The NetBSD Foundation nor the names of its
20 * contributors may be used to endorse or promote products derived
21 * from this software without specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
24 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
25 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
26 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
27 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33 * POSSIBILITY OF SUCH DAMAGE.
36 #ifndef _h_chartype_f
37 #define _h_chartype_f
41 #ifdef WIDECHAR
43 /* Ideally we should also test the value of the define to see if it
44 * supports non-BMP code points without requiring UTF-16, but nothing
45 * seems to actually advertise this properly, despite Unicode 3.1 having
46 * been around since 2001... */
47 #ifndef __NetBSD__
48 #ifndef __STDC_ISO_10646__
49 /* In many places it is assumed that the first 127 code points are ASCII
50 * compatible, so ensure wchar_t indeed does ISO 10646 and not some other
51 * funky encoding that could break us in weird and wonderful ways. */
52 #error wchar_t must store ISO 10646 characters
53 #endif
54 #endif
56 /* Oh for a <uchar.h> with char32_t and __STDC_UTF_32__ in it...
57 * ref: ISO/IEC DTR 19769
59 #if WCHAR_MAX < INT32_MAX
60 #warning Build environment does not support non-BMP characters
61 #endif
63 #define ct_mbtowc mbtowc
64 #define ct_mbtowc_reset mbtowc(0,0,0)
65 #define ct_wctomb wctomb
66 #define ct_wctomb_reset wctomb(0,0)
67 #define ct_wcstombs wcstombs
68 #define ct_mbstowcs mbstowcs
70 #define Char wchar_t
71 #define Int wint_t
72 #define FUN(prefix,rest) prefix ## _w ## rest
73 #define FUNW(type) type ## _w
74 #define TYPE(type) type ## W
75 #define FSTR "%ls"
76 #define STR(x) L ## x
77 #define UC(c) c
78 #define Isalpha(x) iswalpha(x)
79 #define Isalnum(x) iswalnum(x)
80 #define Isgraph(x) iswgraph(x)
81 #define Isspace(x) iswspace(x)
82 #define Isdigit(x) iswdigit(x)
83 #define Iscntrl(x) iswcntrl(x)
84 #define Isprint(x) iswprint(x)
86 #define Isupper(x) iswupper(x)
87 #define Islower(x) iswlower(x)
88 #define Toupper(x) towupper(x)
89 #define Tolower(x) towlower(x)
91 #define IsASCII(x) (x < 0x100)
93 #define Strlen(x) wcslen(x)
94 #define Strchr(s,c) wcschr(s,c)
95 #define Strrchr(s,c) wcsrchr(s,c)
96 #define Strstr(s,v) wcsstr(s,v)
97 #define Strdup(x) wcsdup(x)
98 #define Strcpy(d,s) wcscpy(d,s)
99 #define Strncpy(d,s,n) wcsncpy(d,s,n)
100 #define Strncat(d,s,n) wcsncat(d,s,n)
102 #define Strcmp(s,v) wcscmp(s,v)
103 #define Strncmp(s,v,n) wcsncmp(s,v,n)
104 #define Strcspn(s,r) wcscspn(s,r)
106 #define Strtol(p,e,b) wcstol(p,e,b)
108 #define Width(c) wcwidth(c)
110 #else /* NARROW */
112 #define ct_mbtowc error
113 #define ct_mbtowc_reset
114 #define ct_wctomb error
115 #define ct_wctomb_reset
116 #define ct_wcstombs(a, b, c) (strncpy(a, b, c), strlen(a))
117 #define ct_mbstowcs(a, b, c) (strncpy(a, b, c), strlen(a))
119 #define Char char
120 #define Int int
121 #define FUN(prefix,rest) prefix ## _ ## rest
122 #define FUNW(type) type
123 #define TYPE(type) type
124 #define FSTR "%s"
125 #define STR(x) x
126 #define UC(c) (unsigned char)(c)
128 #define Isalpha(x) isalpha((unsigned char)x)
129 #define Isalnum(x) isalnum((unsigned char)x)
130 #define Isgraph(x) isgraph((unsigned char)x)
131 #define Isspace(x) isspace((unsigned char)x)
132 #define Isdigit(x) isdigit((unsigned char)x)
133 #define Iscntrl(x) iscntrl((unsigned char)x)
134 #define Isprint(x) isprint((unsigned char)x)
136 #define Isupper(x) isupper((unsigned char)x)
137 #define Islower(x) islower((unsigned char)x)
138 #define Toupper(x) toupper((unsigned char)x)
139 #define Tolower(x) tolower((unsigned char)x)
141 #define IsASCII(x) isascii((unsigned char)x)
143 #define Strlen(x) strlen(x)
144 #define Strchr(s,c) strchr(s,c)
145 #define Strrchr(s,c) strrchr(s,c)
146 #define Strstr(s,v) strstr(s,v)
147 #define Strdup(x) strdup(x)
148 #define Strcpy(d,s) strcpy(d,s)
149 #define Strncpy(d,s,n) strncpy(d,s,n)
150 #define Strncat(d,s,n) strncat(d,s,n)
152 #define Strcmp(s,v) strcmp(s,v)
153 #define Strncmp(s,v,n) strncmp(s,v,n)
154 #define Strcspn(s,r) strcspn(s,r)
156 #define Strtol(p,e,b) strtol(p,e,b)
158 #define Width(c) 1
160 #endif
163 #ifdef WIDECHAR
165 * Conversion buffer
167 typedef struct ct_buffer_t {
168 char *cbuff;
169 size_t csize;
170 Char *wbuff;
171 size_t wsize;
172 } ct_buffer_t;
174 #define ct_encode_string __ct_encode_string
175 /* Encode a wide character string and return the UTF-8 encoded result. */
176 public char *ct_encode_string(const Char *, ct_buffer_t *);
178 #define ct_decode_string __ct_decode_string
179 /* Decode a (multi)?byte string and return the wide character string result. */
180 public Char *ct_decode_string(const char *, ct_buffer_t *);
182 /* Decode a (multi)?byte argv string array.
183 * The pointer returned must be free()d when done. */
184 protected Char **ct_decode_argv(int, const char *[], ct_buffer_t *);
186 /* Resizes the conversion buffer(s) if needed. */
187 protected void ct_conv_buff_resize(ct_buffer_t *, size_t, size_t);
188 protected ssize_t ct_encode_char(char *, size_t, Char);
190 #define ct_free_argv(s) el_free(s)
192 #else
193 #define ct_encode_string(s, b) (s)
194 #define ct_decode_string(s, b) (s)
195 #define ct_decode_argv(l, s, b) (s)
196 #define ct_conv_buff_resize(b, os, ns)
197 #define ct_encode_char(d, l, s) (*d = s, 1)
198 #define ct_free_argv(s)
199 #endif
201 #ifndef NARROWCHAR
202 /* Encode a characted into the destination buffer, provided there is sufficent
203 * buffer space available. Returns the number of bytes used up (zero if the
204 * character cannot be encoded, -1 if there was not enough space available). */
206 /* The maximum buffer size to hold the most unwieldly visual representation,
207 * in this case \U+nnnnn. */
208 #define VISUAL_WIDTH_MAX 8
210 /* The terminal is thought of in terms of X columns by Y lines. In the cases
211 * where a wide character takes up more than one column, the adjacent
212 * occupied column entries will contain this faux character. */
213 #define MB_FILL_CHAR ((Char)-1)
215 /* Visual width of character c, taking into account ^? , \0177 and \U+nnnnn
216 * style visual expansions. */
217 protected int ct_visual_width(Char);
219 /* Turn the given character into the appropriate visual format, matching
220 * the width given by ct_visual_width(). Returns the number of characters used
221 * up, or -1 if insufficient space. Buffer length is in count of Char's. */
222 protected ssize_t ct_visual_char(Char *, size_t, Char);
224 /* Convert the given string into visual format, using the ct_visual_char()
225 * function. Uses a static buffer, so not threadsafe. */
226 protected const Char *ct_visual_string(const Char *);
229 /* printable character, use ct_visual_width() to find out display width */
230 #define CHTYPE_PRINT ( 0)
231 /* control character found inside the ASCII portion of the charset */
232 #define CHTYPE_ASCIICTL (-1)
233 /* a \t */
234 #define CHTYPE_TAB (-2)
235 /* a \n */
236 #define CHTYPE_NL (-3)
237 /* non-printable character */
238 #define CHTYPE_NONPRINT (-4)
239 /* classification of character c, as one of the above defines */
240 protected int ct_chr_class(Char c);
241 #endif
244 #endif /* _chartype_f */