index.md - sites - public wiki contents of suckless.org
 (HTM) git clone git://git.suckless.org/sites
 (DIR) Log
 (DIR) Files
 (DIR) Refs
       ---
       index.md (1234B)
       ---
            1 GRAPHEME\_TO\_LOWERCASE(3) - Library Functions Manual
            2 
            3 # NAME
            4 
            5 **grapheme\_to\_lowercase** - convert codepoint array to lowercase
            6 
            7 # SYNOPSIS
            8 
            9 **#include <grapheme.h>**
           10 
           11 *size\_t*  
           12 **grapheme\_to\_lowercase**(*const uint\_least32\_t \*src*, *size\_t srclen*, *uint\_least32\_t \*dest*, *size\_t destlen*);
           13 
           14 # DESCRIPTION
           15 
           16 The
           17 **grapheme\_to\_lowercase**()
           18 function converts the codepoint array
           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 codepoint array
           34 *src*
           35 is interpreted to be NUL-terminated and processing stops when a
           36 NUL-byte is encountered.
           37 
           38 For UTF-8-encoded input data
           39 grapheme\_to\_lowercase\_utf8(3)
           40 can be used instead.
           41 
           42 # RETURN VALUES
           43 
           44 The
           45 **grapheme\_to\_lowercase**()
           46 function returns the number of codepoints 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\_utf8(3),
           59 libgrapheme(7)
           60 
           61 # STANDARDS
           62 
           63 **grapheme\_to\_lowercase**()
           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