Select - Function Summary

Summary:

Finds a value in the series and returns the value or series after it.

Usage:

select series value

Arguments:

series - The series argument. (must be: series port) 

value - The value argument. (must be: any-type) 

Refinements:

/part - Limits the search to a given length or position. 

range - The range argument. (must be: number series port) 

/only - Treats a series value as a single value. 

/case - Characters are case-sensitive. 

/any - Enables the * and ? wildcards. 

/with - Allows custom wildcards. 

wild - Specifies alternates for * and ? (must be: string) 

/skip - Treat the series as records of fixed size 

size - The size argument. (must be: integer) 

Description:

Similar to the FINDfunction, but returns the next value in the series rather than the position of the match. Returns NONE if search failed. 

The /ONLY refinement is evaluated for a block argument and is ignored if the argument is a string. 

    blk: [red 123 green 456 blue 789]

    print select blk 'red

    123

    weather: [

        "Ukiah"      [clear 78 wind from NW at 5 MPH]

        "Santa Rosa" [overcast 65 wind from N at 10 MPH]

        "Eureka"     [rain 62 wind from N at 15 MPH]

    ]

    probe select weather "Eureka"

    [rain 62 wind from N at 15 MPH]

Related:

find - Finds a value in a series and returns the series at the start of it.

switch - Selects a choice and evaluates what follows it.