1 /* toutf8.c Convert strings from system locale into UTF-8.
2 * Copyright (C) 2002, 2003, 2004 Simon Josefsson
4 * This file is part of GNU Libidn.
6 * GNU Libidn is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * GNU Libidn is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with GNU Libidn; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
31 #include "stringprep.h"
35 # define LOCALE_WORKS 1
43 # include <langinfo.h>
49 stringprep_locale_charset_slow (void)
51 return nl_langinfo (CODESET
);
52 const char *charset
= getenv ("CHARSET"); /* flawfinder: ignore */
54 if (charset
&& *charset
)
61 p
= setlocale (LC_CTYPE
, NULL
);
62 setlocale (LC_CTYPE
, "");
64 charset
= nl_langinfo (CODESET
);
66 setlocale (LC_CTYPE
, p
);
68 if (charset
&& *charset
)
76 static const char *stringprep_locale_charset_cache
;
80 * stringprep_locale_charset:
82 * Find out system locale charset.
84 * Note that this function return what it believe the SYSTEM is using
85 * as a locale, not what locale the program is currently in (modified,
86 * e.g., by a setlocale(LC_CTYPE, "ISO-8859-1")). The reason is that
87 * data read from argv[], stdin etc comes from the system, and is more
88 * likely to be encoded using the system locale than the program
91 * You can set the environment variable CHARSET to override the value
92 * returned. Note that this function caches the result, so you will
93 * have to modify CHARSET before calling (even indirectly) any
94 * stringprep functions, e.g., by setting it when invoking the
97 * Return value: Return the character set used by the system locale.
98 * It will never return NULL, but use "ASCII" as a fallback.
101 # define stringprep_locale_charset() nl_langinfo (CODESET)
104 stringprep_locale_charset (void)
106 if (!stringprep_locale_charset_cache
)
107 stringprep_locale_charset_cache
= stringprep_locale_charset_slow ();
109 return stringprep_locale_charset_cache
;
114 * stringprep_convert:
115 * @str: input zero-terminated string.
116 * @to_codeset: name of destination character set.
117 * @from_codeset: name of origin character set, as used by @str.
119 * Convert the string from one character set to another using the
120 * system's iconv() function.
122 * Return value: Returns newly allocated zero-terminated string which
123 * is @str transcoded into to_codeset.
126 stringprep_convert (const char *str
,
127 const char *to_codeset
, const char *from_codeset
)
133 size_t inbytes_remaining
;
134 size_t outbytes_remaining
;
139 if (strcmp (to_codeset
, from_codeset
) == 0)
141 #if defined HAVE_STRDUP || defined _LIBC
145 p
= malloc (strlen (str
) + 1);
148 return strcpy (p
, str
);
152 cd
= iconv_open (to_codeset
, from_codeset
);
154 if (cd
== (iconv_t
) - 1)
157 p
= (ICONV_CONST
char *) str
;
159 inbytes_remaining
= strlen (p
);
160 /* Guess the maximum length the output string can have. */
161 outbuf_size
= (inbytes_remaining
+ 1) * MAX (7, MB_CUR_MAX
);
163 outp
= dest
= malloc (outbuf_size
);
166 outbytes_remaining
= outbuf_size
- 1; /* -1 for NUL */
170 err
= iconv (cd
, (ICONV_CONST
char **) &p
, &inbytes_remaining
,
171 &outp
, &outbytes_remaining
);
173 if (err
== (size_t) - 1)
178 /* Incomplete text, do not report an error */
183 size_t used
= outp
- dest
;
187 newdest
= realloc (dest
, outbuf_size
);
196 outbytes_remaining
= outbuf_size
- used
- 1; /* -1 for NUL */
229 #else /* HAVE_ICONV */
232 stringprep_locale_charset ()
238 stringprep_convert (const char *str
,
239 const char *to_codeset
, const char *from_codeset
)
242 fprintf (stderr
, "libidn: warning: libiconv not installed, cannot "
243 "convert data to UTF-8\n");
244 p
= malloc (strlen (str
) + 1);
251 #endif /* HAVE_ICONV */
254 * stringprep_locale_to_utf8:
255 * @str: input zero terminated string.
257 * Convert string encoded in the locale's character set into UTF-8 by
258 * using stringprep_convert().
260 * Return value: Returns newly allocated zero-terminated string which
261 * is @str transcoded into UTF-8.
264 stringprep_locale_to_utf8 (const char *str
)
266 return stringprep_convert (str
, "UTF-8", stringprep_locale_charset ());
270 * stringprep_utf8_to_locale:
271 * @str: input zero terminated string.
273 * Convert string encoded in UTF-8 into the locale's character set by
274 * using stringprep_convert().
276 * Return value: Returns newly allocated zero-terminated string which
277 * is @str transcoded into the locale's character set.
280 stringprep_utf8_to_locale (const char *str
)
282 return stringprep_convert (str
, stringprep_locale_charset (), "UTF-8");