Tcl_UniCharToLower man page on Scientific

Printed from http://www.polarhome.com/service/man/?qf=Tcl_UniCharToLower&af=0&tf=2&of=Scientific

Tcl_UtfToUpper(3)	    Tcl Library Procedures	     Tcl_UtfToUpper(3)

______________________________________________________________________________

NAME
       Tcl_UniCharToUpper,	 Tcl_UniCharToLower,	   Tcl_UniCharToTitle,
       Tcl_UtfToUpper, Tcl_UtfToLower, Tcl_UtfToTitle - routines  for  manipu‐
       lating 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 charac‐
       ters:

       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 dif‐
       ferent 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 resulting 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 orig‐
       inal string length.

       Tcl_UtfToLower is the same as Tcl_UtfToUpper except it turns each char‐
       acter 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 follow‐
       ing 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)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net