[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 POSALPHA()
 Determines the position of the first alphabetic character in a string
------------------------------------------------------------------------------
 Syntax

     POSALPHA(<cString>,[<lMode>],[<nIgnore>])
        --> nPosition

 Arguments

     <cString>  Designates the string that is searched.

     <lMode>  Designates how the function searches for the first
     alphabetic character in a string.  The default value (.F.) searches for
     the first alphabetic character.

     <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 is the position of the first alphabetic character in
     <cString>.  If no alphabetic character is located, the function returns
     0.

 Description

     Starting from the left, POSALPHA() searches for the first alphabetic
     character in <cString> that corresponds to the first character that can
     be changed by the CA-Clipper LOWER() or UPPER() functions.  If <lMode>
     is .T., then the function searches for the first non-alphabetic
     character.  The <nIgnore> parameter can exclude a specific number of
     characters at the beginning of the <cString> from the search.

 Notes

     .  Notice that characters located when <lMode> is .T. are always
        numbers or special characters, but are never alphabetic characters.

     .  This function works in conjunction with the NATION module
        because different languages use different characters to represent
        their alphabets.

 Example

     cString  :=  "UKLM123"
     ? POSALPHA(cString)                 // Result: 1
     ? POSALPHA(cString, .T.)            // Result: 5
     ? POSALPHA(cString, .F., 2)         // Result: 3


See Also: POSLOWER() POSUPPER() POSRANGE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson