xHarbour Reference Documentation > Function Reference

TokenUpper()

Changes the first character of tokens to upper case.

Syntax

TokenLower( <cString>    , ;
           [<cDelimiter>], ;
           [<nTokenPos>] , ;
           [<nSkipWidth>]  ) --> cResult

Arguments

<cString>

This is a character string to process.

<cDelimiter>

This character string holds a list of characters recognized as delimiters between tokens. The default list of delimiters consist of non-printable characters having the ASCII codes 0, 9, 10, 13, 26, 32, 138 and 141, and the following punctuation characters: ,.;:!?/\<>()!HSH&%+-*

<nTokenPos>

A numeric value indicating the ordinal position of the token to change. If not specified, all tokens are changed.

<nSkipWidth>

This optional numeric value defaults to zero. This causes the function to find empty tokens. To suppress this behavior, set <nSkipWidth> to 1.

Return

The function changes the first character of the specified token to upper case and returns the modified string.

Info

See also:	AtToken(), CSetRef(), NumToken(), Token(), TokenLower()
Category:	CT:String manipulation , Character functions , Token functions
Source:	ct\token1.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example displays results of TokenUpper()

   PROCEDURE Main1
      LOCAL cString := "this is the xharbour compiler"

      ? TokenUpper( cString )       // This Is The XHarbour Compiler

      ? TokenUpper( cString, "x" )  // this is the xHarbour compiler

      ? TokenUpper( cString, , 2 )  // this Is the xharbour compiler

   RETURN