Difference between revisions of "AT()"
Yvonne.milne (Talk | contribs) m (1 revision) |
|||
Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
Function to search for a substring | Function to search for a substring | ||
− | |||
==Syntax== | ==Syntax== | ||
AT(<expC1>, <expC2> | <memofield> [,<expN>]) | AT(<expC1>, <expC2> | <memofield> [,<expN>]) | ||
− | |||
==See Also== | ==See Also== | ||
− | [[ATNEXT()]], [[INLIST()]], [[LEFT()]], [[OCCURS()]], [[RAT()]], [[RIGHT()]], [[SET STRESCAPE]], [[STR()]], [[STREXTRACT()]], [[STRPOS()]], [[STRTRAN()]], [[STUFF()]], [[SUBSTR()]] | + | [[ATNEXT()]], [[GETWORDCOUNT()]], [[GETWORDNUM()]], [[INLIST()]], [[LEFT()]], [[OCCURS()]], [[RAT()]], [[RIGHT()]], [[SET STRESCAPE]], [[STR()]], [[STREXTRACT()]], [[STRPOS()]], [[STRTRAN()]], [[STUFF()]], [[SUBSTR()]] |
− | + | ||
==Description== | ==Description== | ||
AT() is the substring search function. It returns a number signifying the starting position of <expC1> in <expC2> or in the specified memo field. If the substring is not contained within <expC2> or <memofield>, then the function returns the value 0. The leftmost character of a string is in character position 1. The AT() function will return the starting position of the Nth occurrence of <expC1> when the optional numeric expression <expN> is specified. The AT() function is particularly useful in conjunction with the LEFT() or SUBSTR() functions for locating starting points for extracting text from a string. | AT() is the substring search function. It returns a number signifying the starting position of <expC1> in <expC2> or in the specified memo field. If the substring is not contained within <expC2> or <memofield>, then the function returns the value 0. The leftmost character of a string is in character position 1. The AT() function will return the starting position of the Nth occurrence of <expC1> when the optional numeric expression <expN> is specified. The AT() function is particularly useful in conjunction with the LEFT() or SUBSTR() functions for locating starting points for extracting text from a string. | ||
− | |||
==Example== | ==Example== | ||
Line 25: | Line 21: | ||
</code> | </code> | ||
− | |||
− | |||
− | |||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
[[Category:String Data]] | [[Category:String Data]] | ||
[[Category:String Data Functions]] | [[Category:String Data Functions]] |
Revision as of 06:53, 1 October 2012
Contents
Purpose
Function to search for a substring
Syntax
AT(<expC1>, <expC2> | <memofield> [,<expN>])
See Also
ATNEXT(), GETWORDCOUNT(), GETWORDNUM(), INLIST(), LEFT(), OCCURS(), RAT(), RIGHT(), SET STRESCAPE, STR(), STREXTRACT(), STRPOS(), STRTRAN(), STUFF(), SUBSTR()
Description
AT() is the substring search function. It returns a number signifying the starting position of <expC1> in <expC2> or in the specified memo field. If the substring is not contained within <expC2> or <memofield>, then the function returns the value 0. The leftmost character of a string is in character position 1. The AT() function will return the starting position of the Nth occurrence of <expC1> when the optional numeric expression <expN> is specified. The AT() function is particularly useful in conjunction with the LEFT() or SUBSTR() functions for locating starting points for extracting text from a string.
Example
? at("is", "Recital is good") 9 cString1 = "is" cString2 = "Recital is good" ? at(cString1, cString2) 9