Xbasic

Array matching Method

Syntax

dim Element_List as C = <array>.matching(C expression)

Arguments

expressionCharacter

A filter expression that selects elements in an array.

Returns

Element_ListCharacter

Returns a CR-LF delimited list of indices of array elements that match a filter.

Description

Returns a CR-LF delimited list of indices of array elements that match a filter.

Discussion

The <array>.matching() methods returns a CR-LF delimited list of elements from a single dimensional array that match a filter.

Example

dim p[10] as P
p[1].fname="Selwyn"
p[1].lname="Rabins"
p[2].fname="Lenny"
p[2].lname="Forziati"
p[3].fname="Cian"
p[3].lname="Chambliss"
p[4].fname="Richard"
p[4].lname="Rabins"

dim names as c
for each elem in p.matching("lname=\"Rabins\"")
    dim ptr as p = eval("p"+elem)
    names = names + ptr.fname+" "+ptr.lname + crlf()
next

? names
= Selwyn Rabins
Richard Rabins
The output includes the square brackets around each index