Initial Commit

libs/libgrapheme-2.0.2/man/grapheme_to_titlecase.3

@@ -0,0 +1,56 @@
+.Dd 2022-10-06
+.Dt GRAPHEME_TO_TITLECASE 3
+.Os suckless.org
+.Sh NAME
+.Nm grapheme_to_titlecase
+.Nd convert codepoint array to titlecase
+.Sh SYNOPSIS
+.In grapheme.h
+.Ft size_t
+.Fn grapheme_to_titlecase "const uint_least32_t *src" "size_t srclen" "uint_least32_t *dest" "size_t destlen"
+.Sh DESCRIPTION
+The
+.Fn grapheme_to_titlecase
+function converts the codepoint array
+.Va str
+to titlecase and writes the result to
+.Va dest
+up to
+.Va destlen ,
+unless
+.Va dest
+is set to
+.Dv NULL .
+.Pp
+If
+.Va srclen
+is set to
+.Dv SIZE_MAX
+(stdint.h is already included by grapheme.h) the codepoint array
+.Va src
+is interpreted to be NUL-terminated and processing stops when a
+NUL-byte is encountered.
+.Pp
+For UTF-8-encoded input data
+.Xr grapheme_to_titlecase_utf8 3
+can be used instead.
+.Sh RETURN VALUES
+The
+.Fn grapheme_to_titlecase
+function returns the number of codepoints in the array resulting
+from converting
+.Va src
+to titlecase, even if
+.Va destlen
+is not large enough or
+.Va dest
+is
+.Dv NULL .
+.Sh SEE ALSO
+.Xr grapheme_to_titlecase_utf8 3 ,
+.Xr libgrapheme 7
+.Sh STANDARDS
+.Fn grapheme_to_titlecase
+is compliant with the Unicode 15.0.0 specification.
+.Sh AUTHORS
+.An Laslo Hunhold Aq Mt dev@frign.de