CentOS 7.0 - man page for tcl_utftotitle (centos section 3)

Linux & Unix Commands - Search Man Pages

Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Tcl_UtfToUpper(3)		      Tcl Library Procedures			Tcl_UtfToUpper(3)

_________________________________________________________________________________________________

NAME
       Tcl_UniCharToUpper,	Tcl_UniCharToLower,	 Tcl_UniCharToTitle,	  Tcl_UtfToUpper,
       Tcl_UtfToLower, Tcl_UtfToTitle - routines for manipulating the case of Unicode  characters
       and UTF-8 strings

SYNOPSIS
       #include <tcl.h>

       Tcl_UniChar
       Tcl_UniCharToUpper(ch)

       Tcl_UniChar
       Tcl_UniCharToLower(ch)

       Tcl_UniChar
       Tcl_UniCharToTitle(ch)

       int
       Tcl_UtfToUpper(str)

       int
       Tcl_UtfToLower(str)

       int
       Tcl_UtfToTitle(str)

ARGUMENTS
       int ch (in)	       The Tcl_UniChar to be converted.

       char *str (in/out)      Pointer to UTF-8 string to be converted in place.
_________________________________________________________________

DESCRIPTION
       The first three routines convert the case of individual Unicode characters:

       If  ch  represents  a  lower-case  character, Tcl_UniCharToUpper returns the corresponding
       upper-case character.  If no upper-case character is defined,  it  returns  the	character
       unchanged.

       If  ch  represents  an  upper-case character, Tcl_UniCharToLower returns the corresponding
       lower-case character.  If no lower-case character is defined,  it  returns  the	character
       unchanged.

       If  ch  represents  a  lower-case  character, Tcl_UniCharToTitle 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.

       The next three routines convert the case of UTF-8 strings in place in memory:

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

       Tcl_UtfToLower  is the same as Tcl_UtfToUpper except it turns each character in the string
       into its lower-case equivalent.

       Tcl_UtfToTitle is the same as Tcl_UtfToUpper except it turns the first  character  in  the
       string  into  its title-case equivalent and all following characters into their lower-case
       equivalents.

BUGS
       At this time, the case conversions are only defined for the ISO8859-1 characters.  Unicode
       characters above 0x00ff are not modified by these routines.

KEYWORDS
       utf, unicode, toupper, tolower, totitle, case

Tcl					       8.1				Tcl_UtfToUpper(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 11:13 PM.

Unix & Linux Forums Content Copyright©1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?