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