Click or drag to resize

AtC Function

Return the position of the first occurrence of a substring within a string, without regard for case.

Namespace:  XSharp.Core
Assembly:  XSharp.Core (in XSharp.Core.dll) Version: 2.2a
Syntax
 FUNCTION AtC(
	cSearch AS STRING,
	cTarget AS STRING
) AS DWORD
View Source

Parameters

cSearch
Type: String
The substring to search for.
cTarget
Type: String
The string in which to search.

Return Value

Type: UInt32
The position of the first occurrence of <cSearch> within <cTarget>.  If <cSearch> is not found, AtC() returns 0.
Remarks
If you only need to know whether a substring exists within another string, use the InStr() function or the $ operator.  To find the last occurrence of a substring within a string, use RAt().
Examples
These examples show typical use of AtC():
X#
? AtC("bcd", "ABCDE")                // 2
? AtC("a", "bcde")                        // 0
? AtC("a", "AbCdE")                        // 1
This example uses strong typing to do the same thing more efficiently:
X#
LOCAL cSearch AS STRING
LOCAL cTarget AS STRING
cSearch := "a"
cTarget := "AbCdE"
? AtC(cSearch, cTarget)                // 1
See Also