sites

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

index.md (1234B)


      1 GRAPHEME\_TO\_UPPERCASE(3) - Library Functions Manual
      2 
      3 # NAME
      4 
      5 **grapheme\_to\_uppercase** - convert codepoint array to uppercase
      6 
      7 # SYNOPSIS
      8 
      9 **#include <grapheme.h>**
     10 
     11 *size\_t*  
     12 **grapheme\_to\_uppercase**(*const uint\_least32\_t \*src*, *size\_t srclen*, *uint\_least32\_t \*dest*, *size\_t destlen*);
     13 
     14 # DESCRIPTION
     15 
     16 The
     17 **grapheme\_to\_uppercase**()
     18 function converts the codepoint array
     19 *str*
     20 to uppercase 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\_uppercase\_utf8(3)
     40 can be used instead.
     41 
     42 # RETURN VALUES
     43 
     44 The
     45 **grapheme\_to\_uppercase**()
     46 function returns the number of codepoints in the array resulting
     47 from converting
     48 *src*
     49 to uppercase, even if
     50 *destlen*
     51 is not large enough or
     52 *dest*
     53 is
     54 `NULL`.
     55 
     56 # SEE ALSO
     57 
     58 grapheme\_to\_uppercase\_utf8(3),
     59 libgrapheme(7)
     60 
     61 # STANDARDS
     62 
     63 **grapheme\_to\_uppercase**()
     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