Syntax

[the] [first|last|all] (position[s]|indices|index[es]) of [[the] value] %strings% in %string%

Description

Get the first, last or all positions of a character (or text) in another text using 'positions of %texts% in %text%'. Nothing is returned when the value does not occur in the text. Positions range from 1 to the <a href='#ExprIndicesOf'>length</a> of the text (inclusive).

Using 'indices/positions of %objects% in %objects%', you can get the indices or positions of a list where the value at that index is the provided value. Indices are only supported for keyed expressions (e.g. variable lists) and will return the string indices of the given value. Positions can be used with any list and will return the numerical position of the value in the list, counting up from 1. Additionally, nothing is returned if the value is not found in the list.

Whether string comparison is case-sensitive or not can be configured in Skript's config file.

Examples

set {_first} to the first position of "@" in the text argument
if {_s} contains "abc":
	set {_s} to the first (position of "abc" in {_s} + 3) characters of {_s}
	# removes everything after the first "abc" from {_s}

set {_list::*} to 1, 2, 3, 1, 2, 3
set {_indices::*} to indices of the value 1 in {_list::*}
# {_indices::*} is now "1" and "4"

set {_indices::*} to all indices of the value 2 in {_list::*}
# {_indices::*} is now "2" and "5"

set {_positions::*} to all positions of the value 3 in {_list::*}
# {_positions::*} is now 3 and 6

set {_otherlist::bar} to 100
set {_otherlist::hello} to "hi"
set {_otherlist::burb} to 100
set {_otherlist::tud} to "hi"
set {_otherlist::foo} to 100

set {_indices::*} to the first index of the value 100 in {_otherlist::*}
# {_indices::*} is now "bar"

set {_indices::*} to the last index of the value 100 in {_otherlist::*}
# {_indices::*} is now "foo"

set {_positions::*} to all positions of the value 100 in {_otherlist::*}
# {_positions::*} is now 1, 3 and 5

set {_positions::*} to all positions of the value "hi" in {_otherlist::*}
# {_positions::*} is now 2 and 4