any
Syntax
any(func, args…)
Arguments
func is a function.
args … are the required parameters of func. They can be vectors/matrices/tables. They do not need to have the same data form, but they must have the same size. Data size is the number of elements for a vector, the number of columns for a matrix, and the number of rows for a table.
Details
Apply a function on each element of all arguments. The template runs through each element of a vector, each column of a matrix, and each row of a table. It stops execution and returns a true value as soon as one function call returns a true value. It returns a false value if all function calls return false values.
Examples
Template any
on a vector:
$ x = 1 2 3 11 12 13 NULL 102 103;
$ y = x cut 3;
$ y;
([1,2,3],[11,12,13],[,102,103])
$ any(hasNull, y);
1
// check if any of [1,2,3],[11,12,13],[,102,103] has NULL values;
$ x=1 25 7 15 11 197 16 18 23;
$ y=x cut 3;
$ y;
([1,25,7],[15,11,197],[16,18,23])
$ any(in, 7 8 23, y);
1
// return true since 7 is in [1, 25, 7], although 8 is not in [15,11,197]
$ any(in, 8 20 19, y);
0
// 8 is not in [1,25,7], 20 is not in [15,11,197], and 19 is not in [16,18,23]
$ any(lt, 4 5 6, 1 2 3);
0
// check if 4<1, 5<2 and 6<3
$ any(<, 4 5 6, 1 7 3);
1
// return true as 5<7 is true
Template any
on a matrix. For a matrix, the template runs through each column.
$ x=1..6$2:3;
$ x;
#0 |
#1 |
#2 |
---|---|---|
1 |
3 |
5 |
2 |
4 |
6 |
$ any(in, 6 1 4, x);
0
$ any(in, 3 4 2, x);
1
// return true as 4 is in the second column of matrix x
Template any
on a table. For a table, the template runs through each row. In the following example, we define a function varscompare
to compare the values of 2 variables in a table.
$ x=table(1 2 3 as a, 4 5 6 as b);
$ x;
a |
b |
---|---|
1 |
4 |
2 |
5 |
3 |
6 |
$ def varscompare(t): t.a>t.b;
$ any(varscompare, x);
0
$ y=table(1 7 3 as a, 4 5 6 as b);
$ y;
a |
b |
---|---|
1 |
4 |
7 |
5 |
3 |
6 |
$ any(varscompare, y);
1
//return true as 7>5 is true