mulle-utf

🔤 UTF8-16-32 analysis and manipulation library

It is a C (C99) library to analyze and convert unicode strings. It also contains some limited <string.h> like functionality for UTF16 and UTF32. It is the backbone of NSString.

Release Version	Release Notes	AI Documentation
	RELEASENOTES	DeepWiki for mulle-utf

API

Documentation	Description
mulle_char7	Encode small ASCII strings into integers
mulle_char5	Encode some more smallish ASCII strings integers
ctype	Character type information
conversion	Character and string conversions
information	Analyze and classify string encodings
string	Primitive UTF16 and UTF32 string handling

size_t is used for byte-sized (really char-sized) lengths. UTF16 and UTF32 use size_t.

You are here

Add

This project is a component of the mulle-core library. As such you usually will not add or install it individually, unless you specifically do not want to link against mulle-core.

Add as an individual component

Use mulle-sde to add mulle-utf to your project:

mulle-sde add github:mulle-c/mulle-utf

To only add the sources of mulle-utf with dependency sources use clib:

clib install --out src/mulle-c mulle-c/mulle-utf

Add -isystem src/mulle-c to your CFLAGS and compile all the sources that were downloaded with your project.

Install

Use mulle-sde to build and install mulle-utf and all dependencies:

mulle-sde install --prefix /usr/local \
   https://github.com/mulle-c/mulle-utf/archive/latest.tar.gz

Legacy Installation

Install the requirements:

Requirements	Description
mulle-allocator	🔄 Flexible C memory allocation scheme
mulle-data	#️⃣ A collection of hash functions

Download the latest tar or zip archive and unpack it.

Install mulle-utf into /usr/local with cmake:

PREFIX_DIR="/usr/local"
cmake -B build                               \
      -DMULLE_SDK_PATH="${PREFIX_DIR}"       \
      -DCMAKE_INSTALL_PREFIX="${PREFIX_DIR}" \
      -DCMAKE_PREFIX_PATH="${PREFIX_DIR}"    \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK