Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r097

D toc

Excerpt

Computes the index at which a specified element is first found within an array. Indexing is left to right.

  • Leftmost index value is 0.
  • If the element is not found, null is returned.
  • For right-to-left searching, use ARRAYRIGHTINDEXOF. 
    • If only one element exists in the array, both functions return the same value.
    • For more information, see ARRAYRIGHTINDEXOF Function.

D s lang vs sql

D s
snippetBasic

Array literal reference example:

D lang syntax
RawWrangletrue
Typeref
showNotetrue
WrangleTextderive type:single value:arrayindexof(["A","B","C","D"],"C")

arrayindexof(["A","B","C","D"],"C")

Output: Returns the index of the element "C" in the array, which is 2 in an 0-based index

Column reference example:

D lang syntax
RawWrangletrue
Typeref
showNotetrue
WrangleTextderive type:single value:arrayindexof([myValues],myElement) as:myIndexOfmyValues'

arrayindexof([myValues],myElement)


Output:
 Returns the index in the myValues arrays for the elements listed in the myElement column.

D s
snippetSyntax

D lang syntax
RawWrangletrue
Typesyntax
showNotetrue
WrangleTextderive type:single value:arrayindexof(array_ref,my_element)

arrayindexof(array_ref,my_element)


ArgumentRequired?Data TypeDescription
array_refYarray or stringName of Array column, Array literal, or function returning an Array to apply to the function
my_elementYanyThe element to locate in the array

D s lang notes

array_ref

Name of the array column, array literal, or function returning an array whose element you want to locate.

  • Multiple columns and wildcards are not supported.

D s
snippetusage

 

Required?Data TypeExample Value
YesString (column reference or function) or array literalmyArray1

my_element

Element literal that you wish to locate in the array. It can be a value of any data type.

D s
snippetusage

 

Required?Data TypeExample Value
YesAny"1st"

D s
snippetExamples

Example - Computing points based on position of finish

Include Page
EXAMPLE - ARRAYINDEXOF and ARRAYRIGHTINDEXOF Functions
EXAMPLE - ARRAYINDEXOF and ARRAYRIGHTINDEXOF Functions

D s also
labelnested