Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / libcharset

libiconv 1.16

    1:           LIBCHARSET - portable character set determination library
    2: 
    3: This library provides a function which determines the character set / encoding
    4: of text in the currently selected locale (the LC_CTYPE locale facet).
    5: 
    6: It is useful for portable programs which need to process text in other
    7: encodings and locales than the currently selected one. Possible uses:
    8: 
    9:   * Use of Unicode in POSIX compliant applications.
   10:   * Conversion of text between the current locale's encoding and UTF-8 (or
   11:     any other given encoding).
   12:   * Mail agents.
   13: 
   14: In theory, this would be very simple: POSIX provides the nl_langinfo function,
   15: in such a way that
   16: 
   17:                   nl_langinfo (CODESET)
   18: 
   19: returns the encoding name. But the nl_langinfo function still does not exist
   20: on some systems, and on those where it exists it returns unstandardized
   21: variations of the encoding names, like (on Solaris) "PCK" for "Shift_JIS".
   22: 
   23: This library fixes these flaws and provides a function
   24: 
   25:        const char * locale_charset (void);
   26: 
   27: It determines the current locale's character encoding, and canonicalizes it
   28: into one of the canonical names listed in localcharset.h. The result must
   29: not be freed; it is statically allocated. If the canonical name cannot be
   30: determined, the result is a non-canonical name.
   31: 
   32: 
   33: Installation:
   34: 
   35: As usual for GNU packages:
   36: 
   37:     $ ./configure --prefix=/usr/local
   38:     $ make
   39:     $ make install
   40: 
   41: 
   42: This library is used in
   43:   GNU coreutils
   44:   GNU gettext
   45:   GNU clisp
   46: 
   47: 
   48: To integrate this library into your package:
   49: - Either from this package. See file INTEGRATE.
   50: - Or from gnulib. See
   51:   <https://www.gnu.org/software/gnulib/MODULES.html#module=localcharset>
   52: 
   53: 
   54: Distribution:
   55:     The libcharset directory of
   56:     ftp://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz
   57: 
   58: Homepage:
   59:     https://haible.de/bruno/packages-libcharset.html
   60: 
   61: 
   62: Bruno Haible <bruno@clisp.org>