[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
POSUPPER()
Finds the position of the first upper case, alphabetic character
------------------------------------------------------------------------------
Syntax
POSUPPER(<cString>,[<lMode>],[<nIgnore>])
--> nPosition
Arguments
<cString> Designates the string that is searched.
<lMode> Designates how the function searches for the first upper
case, alphabetic character. The default value (.F.) searches for the
first alphabetic character that would be changed by the CA-Clipper
function LOWER().
<nIgnore> Designates the number of characters at the beginning of
the character string that are excluded from the search. The default
value excludes none (0).
Returns
The value returned corresponds to the position of the character located.
When no matching character is found, the function returns 0.
Description
Starting from the beginning of the string, POSUPPER() searches for the
first upper case, alphabetic character in the <cString> that corresponds
to the first character that would be changed by the CA-Clipper LOWER()
function. If <lMode> is .T., the function searches for the first non-
alphabetic character that would not be changed by LOWER(). The
<nIgnore> parameter can exclude a specific number of characters at the
beginning of <cString>.
Notes
. Characters located when the <lMode> parameter is .T. are not
necessarily lower case, alphabetic characters.
. The function works in conjunction with the NATION module
because different languages use different characters to represent
their alphabets.
Example
cString := "123abcUABC"
? POSUPPER(cString) // Result: 7
? POSUPPER(cString, .T.) // Result: 1
? POSUPPER(cString, .F., 7) // Result: 8
See Also:
POSALPHA()
POSLOWER()
POSRANGE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson