{"id":7336,"date":"2022-12-20T19:37:44","date_gmt":"2022-12-20T22:37:44","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/tcl_utftoupper-man3-3\/"},"modified":"2022-12-20T19:37:44","modified_gmt":"2022-12-20T22:37:44","slug":"tcl_utftoupper-man3-3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/tcl_utftoupper-man3-3\/","title":{"rendered":"Tcl_UtfToUpper (man3)"},"content":{"rendered":"

Tcl_UtfToUpper<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
ARGUMENTS<\/a>
DESCRIPTION<\/a>
BUGS<\/a>
KEYWORDS<\/a> <\/p>\n

\n

______________________________________________________________________________<\/p>\n

NAME <\/a> <\/h2>\n

Tcl_UniCharToUpper, Tcl_UniCharToLower, Tcl_UniCharToTitle, Tcl_UtfToUpper, Tcl_UtfToLower, Tcl_UtfToTitle \u2212 routines for manipulating the case of Unicode characters and UTF-8 strings<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

#include <\/b><\/p>\n

Tcl_UniChar
Tcl_UniCharToUpper<\/b>(ch<\/i>)<\/p>\n

Tcl_UniChar
Tcl_UniCharToLower<\/b>(ch<\/i>)<\/p>\n

Tcl_UniChar
Tcl_UniCharToTitle<\/b>(ch<\/i>)<\/p>\n

int
Tcl_UtfToUpper<\/b>(str<\/i>)<\/p>\n

int
Tcl_UtfToLower<\/b>(str<\/i>)<\/p>\n

int
Tcl_UtfToTitle<\/b>(str<\/i>)<\/p>\n

ARGUMENTS <\/a> <\/h2>\n\n\n\n
<\/td>\n\n

int ch<\/i> (in)<\/p>\n<\/td>\n

<\/td>\n\n

The Unicode character to be converted.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

char *str<\/i> (in\/out)<\/p>\n<\/td>\n

<\/td>\n\n

Pointer to UTF-8 string to be converted in place.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

______________________________________________________________________________<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

The first three routines convert the case of individual Unicode characters:<\/p>\n

If ch<\/i> represents a lower-case character, Tcl_UniCharToUpper<\/b> returns the corresponding upper-case character. If no upper-case character is defined, it returns the character unchanged.<\/p>\n

If ch<\/i> represents an upper-case character, Tcl_UniCharToLower<\/b> returns the corresponding lower-case character. If no lower-case character is defined, it returns the character unchanged.<\/p>\n

If ch<\/i> represents a lower-case character, Tcl_UniCharToTitle<\/b> returns the corresponding title-case character. If no title-case character is defined, it returns the corresponding upper-case character. If no upper-case character is defined, it returns the character unchanged. Title-case is defined for a small number of characters that have a different appearance when they are at the beginning of a capitalized word.<\/p>\n

The next three routines convert the case of UTF-8 strings in place in memory:<\/p>\n

Tcl_UtfToUpper<\/b> changes every UTF-8 character in str<\/i> to upper-case. Because changing the case of a character may change its size, the byte offset of each character in the resulting string may differ from its original location. Tcl_UtfToUpper<\/b> writes a null byte at the end of the converted string. Tcl_UtfToUpper<\/b> returns the new length of the string in bytes. This new length is guaranteed to be no longer than the original string length.<\/p>\n

Tcl_UtfToLower<\/b> is the same as Tcl_UtfToUpper<\/b> except it turns each character in the string into its lower-case equivalent.<\/p>\n

Tcl_UtfToTitle<\/b> is the same as Tcl_UtfToUpper<\/b> except it turns the first character in the string into its title-case equivalent and all following characters into their lower-case equivalents.<\/p>\n

BUGS <\/a> <\/h2>\n

At this time, the case conversions are only defined for the Unicode plane 0 characters. The result for Unicode characters above 0xffff is undefined, but – actually – only the lower 16 bits of the character value is handled.<\/p>\n

KEYWORDS <\/a> <\/h2>\n

utf, unicode, toupper, tolower, totitle, case<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

Tcl_UniCharToUpper, Tcl_UniCharToLower, Tcl_UniCharToTitle, Tcl_UtfToUpper, Tcl_UtfToLower, Tcl_UtfToTitle \u2212 routines for manipulating the case of Unicode characters and UTF-8 strings <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2536],"tags":[2538,3007,3654],"class_list":["post-7336","post","type-post","status-publish","format-standard","hentry","category-3-llamadas-de-bibliotecas","tag-2538","tag-man3","tag-tcl_utftoupper"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7336","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7336"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7336\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7336"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7336"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7336"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}