firstHit
Syntax
firstHit(func, X, target)
Arguments
func can only be the following operators: >, >=, <, <=, !=, <>, ==.
X is a vector/matrix/table.
target is a scalar of the same type as X indicating the value to be compared with X.
Details
Return the first element in X that satisfies the condition X func target (e.g. X>5).
If no element in X satisfies the condition, return a NULL vlaue.
NULL values are ignored in firstHit. Use firstNot to find the first non-NULL value.
Examples
1 $ X = NULL 3.2 4.5 1.2 NULL 7.8 0.6 9.1
2 $ firstHit(<, X, 2.5)
3 1.2
4
5 // return null value if no element satisfies the condition
6 $ firstHit(>, X, 10.0)
7 NULL
Related Function: ifirstHit