offset

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
offset(<charsToFind>, <stringToSearch> [, <charsToSkip>])
Summary

Returns the number of characters between the first character of a value and an occurrence of a specified string.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
charsToFind
stringToSearch
charsToSkip

A non-negative integer. If you don't specify how many charsToSkip, the offset function does not skip any items and starts at the beginning of the stringToSearch.

Example
offset("c","abcde") -- returns 3
offset("b","abacadabra",2) -- returns 6
offset("bark","embarking") -- returns 3
Values
NameTypeDescription
return

The offset function returns a non-negative integer.

RelatedProperty: caseSensitive
Operator: begins with
Keyword: character, characters, integer, string, point
Control Structure: function
Function: wordOffset, itemOffset, length, lineOffset, value
Command: find, sort container
Glossary: return, non-negative, property
Description

Use the offset function to find where a string occurs in another string.

The value returned by the offset function is the number of the character where charsToFind appears in stringToSearch. If the charsToFind is not in stringToSearch, the offset function returns zero.

If the charsToFind contains more than one character, and the entire charsToFind appears in the stringToSearch, the offset function returns the character number where the charsToFind starts.

If you specify how many charsToSkip, the offset function skips the specified number of characters in the stringToSearch. The value returned is relative to this starting point instead of the beginning of the stringToSearch.

Note: The offset is affected by the caseSensitive property. By default, this property is set to false, meaning uppercase letters and their lowercase equivalents are treated as the same. For example, offset("A","abcABC") returns 1 by default, however after setting the caseSensitive to true, it returns 4 instead.

Tagstext processing