find - matarrs/find.ts - Ubique documentation

function find



find(x: array<boolean | number> | matrix<boolean | number>): array

Finds the indices of nonzero (true) elements in an array or matrix.

Given an input array or matrix, returns the indices of elements that are true. For a matrix, the indices are flattened row-wise.

Examples

import { assertEquals } from "jsr:@std/assert";

find([0.3, -0.4, 0.5, 0.9].map(a => a > 0)); // [0, 2, 3]

import { assertEquals } from "jsr:@std/assert";

find([[true, true], [false, true]]); // [0, 1, 3]

import { assertEquals } from "jsr:@std/assert";

find([]); // []

import { assertEquals } from "jsr:@std/assert";

find([false, false, false]); // []

import { assertEquals } from "jsr:@std/assert";

find([true, true, true]); // [0, 1, 2]



x: array<boolean | number> | matrix<boolean | number>

Input array or matrix.

array

An array of indices where the values are true.

If no arguments are provided or if the input is not an array or matrix.