52 lines
1.1 KiB
Groff
52 lines
1.1 KiB
Groff
.Dd 2022-10-06
|
|
.Dt GRAPHEME_IS_TITLECASE_UTF8 3
|
|
.Os suckless.org
|
|
.Sh NAME
|
|
.Nm grapheme_is_titlecase_utf8
|
|
.Nd check if UTF-8-encoded string is titlecase
|
|
.Sh SYNOPSIS
|
|
.In grapheme.h
|
|
.Ft size_t
|
|
.Fn grapheme_is_titlecase_utf8 "const char *str" "size_t len" "size_t *caselen"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Fn grapheme_is_titlecase_utf8
|
|
function checks if the UTF-8-encoded string
|
|
.Va str
|
|
is titlecase and writes the length of the matching titlecase-sequence to the integer pointed to by
|
|
.Va caselen ,
|
|
unless
|
|
.Va caselen
|
|
is set to
|
|
.Dv NULL .
|
|
.Pp
|
|
If
|
|
.Va len
|
|
is set to
|
|
.Dv SIZE_MAX
|
|
(stdint.h is already included by grapheme.h) the UTF-8-encoded string
|
|
.Va src
|
|
is interpreted to be NUL-terminated and processing stops when a
|
|
NUL-byte is encountered.
|
|
.Pp
|
|
For non-UTF-8 input data
|
|
.Xr grapheme_is_titlecase 3
|
|
can be used instead.
|
|
.Sh RETURN VALUES
|
|
The
|
|
.Fn grapheme_is_titlecase_utf8
|
|
function returns
|
|
.Dv true
|
|
if the UTF-8-encoded string
|
|
.Va str
|
|
is titlecase, otherwise
|
|
.Dv false .
|
|
.Sh SEE ALSO
|
|
.Xr grapheme_is_titlecase 3 ,
|
|
.Xr libgrapheme 7
|
|
.Sh STANDARDS
|
|
.Fn grapheme_is_titlecase_utf8
|
|
is compliant with the Unicode 15.0.0 specification.
|
|
.Sh AUTHORS
|
|
.An Laslo Hunhold Aq Mt dev@frign.de
|