searchb( search_text, within_text, start_num )
Searches the text for a particular substring, returning the positional index of the first byte of the first match.
Keyword | Type | Description |
---|---|---|
|
Text |
The text that will be searched for. |
|
Text |
The text to be searched. |
|
Number |
The index of the within_text value from which to start searching. 1 by default. |
Number
The search_text parameter supports ?
as a wildcard character.
The first byte of the entire within_text value has an index of 1.
1
searchb("to", "boston")
Returns 4
.
1
searchb("tt", "café latte")
Returns 9
. The "é" character counts as 2 bytes.
1
searchb("o", "boston", 4)
Returns 5
. The function starts searching the string at byte index 4.
1
searchb({ "t", "i" }, { "boston", "paris" })
Returns { 4, 4 }
.
1
searchb("o", "boston", { 1, 3 })
Returns { 2, 5 }
. The search is repeated at each start index in the list.
1
searchb("s??n", { "boston", "paris" })
Returns { 3, 0 }
.
1
searchb({}, "boston")
Returns {}
.
1
searchb("o", "boston", "")
Returns 0
. The function always returns 0 when given an empty string start_num.
Feature | Compatibility | Note |
---|---|---|
Portals | Compatible | |
Offline Mobile | Compatible | |
Sync-Time Custom Record Fields | Compatible | Can be used to create a custom record field that only evaluates at sync time. |
Real-Time Custom Record Fields | Incompatible | Custom record fields that evaluate in real time must be configured using one or more Custom Field functions. |
Process Reports | Compatible | |
Process Events | Compatible |
searchb() Function