Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.0 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Elementary Functions > Search and sort > find


find indices of boolean vector or matrix true elements


[ii]=find(x [,nmax])
[i1,i2,..]=find(x [,nmax])



may be a boolean vector, a boolean matrix, a boolean hypermatrix, a "standard" matrix or hypermatrix


an integer giving the maximum number of indices to return. The default value is -1 which stands for "all". This option can be used for efficiency, to avoid searching all indices.

ii, i1, i2, ..

integer vectors of indices or empty matrices


If x is a boolean matrix,

ii=find(x) returns the vector of indices i for which x(i) is "true". If no true element found find returns an empty matrix.

[i1,i2,..]=find(x) returns vectors of indices i1 (for rows) and i2 (for columns),.. such that x(i1(n),i2(n),..) is "true". If no true element found find returns empty matrices in i1, i2, ...

if x is a standard matrix or hypermatrix find(x) is interpreted as find(x<>0)

find([]) returns []


beers=["Desperados", "Leffe", "Kronenbourg", "Heineken"];
find(beers=="Leffe") // OK
find(beers=="1664") // KO
find(beers=="Foster") // KO
beers=[beers, "Foster"]
find(beers=="Foster") // OK


w=find(B<0.4,2) //at most 2 returned values

H=rand(4,3,5); //an hypermatrix


See also

  • boolean — Scilab Objects, boolean variables and operators & | ~
  • extraction — matrix and list entry extraction
  • insertion — partial variable assignation or modification
  • vectorfind — locates occurences of a (wildcarded) vector in a matrix or hypermatrix
Report an issue
<< dsearch Search and sort gsort >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 25 08:49:19 CET 2020