xHarbour Reference Documentation > Function Reference

TokenLower()

Changes the first character of tokens to lower 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 lower case and returns the modified string.

Info

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

Example

// The example displays results of TokenLower()

   PROCEDURE Main
      LOCAL cString := "This Is The XHarbour Compiler"

      ? TokenLower( cString )       // this is the xHarbour compiler

      ? TokenLower( cString, "X" )  // This Is The Xharbour Compiler

      ? TokenLower( cString, , 2 )  // This is The XHarbour Compiler

   RETURN