Skip to content
Mirror of the libunistring repository https://savannah.gnu.org/git/?group=libunistring
Perl Shell M4 C Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Admin
build-aux
doc
gnulib-local
gnulib-m4
lib
m4
tests
woe32dll
.gitattributes
.gitignore
.gitmodules
AUTHORS
BUGS
COPYING
COPYING.LIB
ChangeLog
DEPENDENCIES
HACKING
INSTALL
INSTALL.windows
Makefile.am
NEWS
README
THANKS
autogen.sh
configure.ac
gitsub.sh
version.sh

README

           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
  - 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-0.9.10.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>.


Bruno Haible <bruno@clisp.org>
You can’t perform that action at this time.