sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (1240B)


      1 GRAPHEME\_TO\_LOWERCASE\_UTF8(3) - Library Functions Manual
      2 
      3 # NAME
      4 
      5 **grapheme\_to\_lowercase\_utf8** - convert UTF-8-encoded string to lowercase
      6 
      7 # SYNOPSIS
      8 
      9 **#include <grapheme.h>**
     10 
     11 *size\_t*  
     12 **grapheme\_to\_lowercase\_utf8**(*const char \*src*, *size\_t srclen*, *char \*dest*, *size\_t destlen*);
     13 
     14 # DESCRIPTION
     15 
     16 The
     17 **grapheme\_to\_lowercase\_utf8**()
     18 function converts the UTF-8-encoded string
     19 *str*
     20 to lowercase and writes the result to
     21 *dest*
     22 up to
     23 *destlen*,
     24 unless
     25 *dest*
     26 is set to
     27 `NULL`.
     28 
     29 If
     30 *srclen*
     31 is set to
     32 `SIZE_MAX`
     33 (stdint.h is already included by grapheme.h) the UTF-8-encoded string
     34 *src*
     35 is interpreted to be NUL-terminated and processing stops when a
     36 NUL-byte is encountered.
     37 
     38 For non-UTF-8 input data
     39 grapheme\_to\_lowercase(3)
     40 can be used instead.
     41 
     42 # RETURN VALUES
     43 
     44 The
     45 **grapheme\_to\_lowercase\_utf8**()
     46 function returns the number of bytes in the array resulting
     47 from converting
     48 *src*
     49 to lowercase, even if
     50 *destlen*
     51 is not large enough or
     52 *dest*
     53 is
     54 `NULL`.
     55 
     56 # SEE ALSO
     57 
     58 grapheme\_to\_lowercase(3),
     59 libgrapheme(7)
     60 
     61 # STANDARDS
     62 
     63 **grapheme\_to\_lowercase\_utf8**()
     64 is compliant with the Unicode 15.0.0 specification.
     65 
     66 # AUTHORS
     67 
     68 Laslo Hunhold ([dev@frign.de](mailto:dev@frign.de))
     69 
     70 suckless.org - 2022-10-06