Find - Function Summary
Finds a value in a series and returns the series at the start of it.
find series value
series - The series argument. (must be: series port bitset)
value - The value argument. (must be: any-type)
/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)
/match - Performs comparison and returns the tail of the match.
/tail - Returns the end of the string.
/last - Backwards from end of string.
/reverse - Backwards from the current position.
Returns NONE if the value was not found. Otherwise, returns a position in the series where the value was found. Many refinements to this function are available.
/TAIL indicates that the position just past the match should be returned.
The /MATCH refinement can be used to perform a character by character match of the input value to the series. The position just past the match is returned.
Wildcards can be specified with /ANY and case sensitive comparisons can be made with /CASE.
The /ONLY refinement applies to block values and is ignored for strings.
The /LAST refinement causes FIND to search from the TAIL of the series toward the HEAD.
/REVERSE searches backwards from the current position toward the head.