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.5
Syntax
 FUNCTION AtC(
	cSearch AS STRING,
	cTarget AS STRING
) AS DWORD

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#
1? AtC("bcd", "ABCDE")        // 2
2? AtC("a", "bcde")            // 0
3? AtC("a", "AbCdE")            // 1
This example uses strong typing to do the same thing more efficiently:
X#
1LOCAL cSearch AS STRING
2LOCAL cTarget AS STRING
3cSearch := "a"
4cTarget := "AbCdE"
5? AtC(cSearch, cTarget)        // 1
See Also