stringprep_utf8_to_ucs4(3)

stringprep_utf8_to_ucs43

Api function

Usage

#include <stringprep.h>

uint32_t * stringprep_utf8_to_ucs4(const char * str, ssize_t len, size_t * items_written);

Arguments

const char * str

a UTF-8 encoded string

ssize_t len

the maximum length of str to use. If len < 0, then the string is nul-terminated.

size_t * items_written

location to store the number of characters in the result, or NULL.

Overview

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. The function now performs error checking to verify that the input is valid UTF-8 (before it was documented to not do error checking).

Return value: a pointer to a newly allocated UCS-4 string. This value must be deallocated by the caller.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 8 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 9–11
  7. 12
  8. 13
  9. Arch

Reporting bugs

Report bugs to <[email protected]>.
General guidelines for reporting bugs: https://www.gnu.org/gethelp/
GNU Libidn home page: https://www.gnu.org/software/libidn/

From libidn 1.44-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.