libunistring: Main Page - doxygen documentation

Searching...

No Matches

Some Fossies usage hints in advance:

To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies libunistring-1.1.tar.xz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).

           GNU LIBUNISTRING - Unicode string library

This library provides functions for manipulating Unicode strings and
for manipulating C strings according to the Unicode standard.

It consists of the following parts:

  unistr.h     elementary string functions
  uniconv.h    conversion from/to legacy encodings
  unistdio.h   formatted output to strings
  uniname.h    character names
  unictype.h   character classification and properties
  uniwidth.h   string width when using nonproportional fonts
  unigbrk.h    grapheme cluster breaks
  uniwbrk.h    word breaks
  unilbrk.h    line breaking algorithm
  uninorm.h    normalization (composition and decomposition)
  unicase.h    case folding
  uniregex.h   regular expressions (not yet implemented)

libunistring is for you if your application involves non-trivial text
processing, such as upper/lower case conversions, line breaking, operations
on words, or more advanced analysis of text. Text provided by the user can,
in general, contain characters of all kinds of scripts. The text processing
functions provided by this library handle all scripts and all languages.

libunistring is for you if your application already uses the ISO C / POSIX
<ctype.h>, <wctype.h> functions and the text it operates on is provided by
the user and can be in any language.

libunistring is also for you if your application uses Unicode strings as
internal in-memory representation.


Installation
------------

As usual for GNU packages:

    $ ./configure --prefix=[[PREFIX]]     where [[PREFIX]] is e.g. $HOME/local
    $ make
    $ make install


Copyright
---------

The libunistring library and its header files are dual-licensed under
"the GNU LGPLv3+ or the GNU GPLv2+". This means, you can use it under either
  - the terms of the GNU Lesser General Public License (LGPL) version 3 or
    (at your option) any later version, or
  - the terms of the GNU General Public License (GPL) version 2 or
    (at your option) any later version, or
  - the same dual license "the GNU LGPLv3+ or the GNU GPLv2+".

You find the GNU LGPL version 3 in the file COPYING.LIB.  This license is
based on the GNU GPL version 3, see file COPYING.

You can find the GNU GPL version 2 at
<https://www.gnu.org/licenses/old-licenses/gpl-2.0.html>.

Note: This dual license makes it possible for the libunistring library
to be used by packages under GPLv2 or GPLv2+ licenses, in particular. See
the table in <https://www.gnu.org/licenses/gpl-faq.html#AllCompatibility>.

The documentation is under another license; see in the documentation.


Download
--------

    https://ftp.gnu.org/gnu/libunistring/libunistring-1.1.tar.gz

Homepage
--------

    https://www.gnu.org/software/libunistring/

Bug reports
-----------

Report bugs
  - in the bug tracker at <https://savannah.gnu.org/projects/libunistring>
  - or by email to <bug-libunistring@gnu.org>.

Join the GNU project
--------------------

See file JOIN-GNU.


Bruno Haible <bruno@clisp.org>