any

Determinare se uno qualsiasi degli elementi dell'array è diverso da zero

Sintassi

B = any(A)

B = any(A,'all')

B = any(A,dim)

B = any(A,vecdim)

Descrizione

B = any(A) esegue test lungo la prima dimensione dell'array di A la cui dimensione non è uguale a 1 e determina se uno qualsiasi degli elementi è un numero diverso da zero o logico 1 (true). In sostanza, any è un'estensione naturale dell'operatore logico OR.

• Se A è un vettore, B = any(A) restituisce il valore logico 1 (true) se uno qualsiasi degli elementi di A è un numero diverso da zero o è logico 1 e restituisce il valore logico 0 (false) se tutti gli elementi sono zero.

• Se A è una matrice non vuota e non vettoriale, B = any(A) tratta le colonne di A come vettori, restituendo un vettore riga di 1 e 0 logici.

• Se A è una matrice vuota 0x0, any(A) restituisce il valore logico 0 (false).

• Se A è un array multidimensionale, any(A) agisce lungo la prima dimensione dell'array la cui grandezza non è uguale a 1 e restituisce un array di valori logici. La grandezza di questa dimensione diventa 1, mentre le grandezze di tutte le altre dimensioni rimangono invariate.

B = any(A,'all') esegue test su tutti gli elementi di A. Questa sintassi è valida per la release R2018b di MATLAB^® e successive.

B = any(A,dim) esegue test sugli elementi lungo la dimensione dim. L'input dim è un numero intero positivo.

B = any(A,vecdim) esegue test sugli elementi in base alle dimensioni specificate nel vettore vecdim. Ad esempio, se A è una matrice, any(A,[1 2]) esegue test su tutti gli elementi in A poiché ogni elemento di una matrice è contenuto nella porzione di array definita dalle dimensioni 1 e 2.

Esempi

Esecuzione di test sulle colonne della matrice

Creare una matrice 3x3.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

Eseguire test su ogni colonna per gli elementi diversi da zero.

B = any(A)

B = 1×3 logical array

   0   0   1

Riduzione di un vettore logico a una singola condizione

Creare un vettore di valori decimali ed eseguire test per verificare quali valori sono inferiori a 0,5.

A = [0.53 0.67 0.01 0.38 0.07 0.42 0.69];
B = (A < 0.5)

B = 1×7 logical array

   0   0   1   1   1   1   0

L'output è un vettore di valori logici. La funzione any riduce tale vettore di valori logici a una singola condizione. In questo caso, B = any(A < 0.5) produce il valore logico 1.

Questo rende any particolarmente utile nelle dichiarazioni if.

if any(A < 0.5)

%do something

else

%do something else

end

Il codice viene eseguito in base a una singola condizione, anziché a un vettore di condizioni potenzialmente in conflitto.

Esecuzione di test su array di qualsiasi dimensione

Creare un array multidimensionale 3x7x5 ed eseguire test per verificare se uno qualsiasi degli elementi è maggiore di 3.

A = rand(3,7,5) * 5;
B = any(A(:) > 3)

B = logical
   1

È anche possibile eseguire test sull'array per gli elementi inferiori a zero.

B = any(A(:) < 0)

B = logical
   0

La sintassi A(:) trasforma gli elementi di A in un singolo vettore colonna; quindi, questo tipo di dichiarazione può essere utilizzato su un array di qualsiasi dimensione.

Esecuzione di test sulle righe della matrice

Creare una matrice 3x3.

A = [0 0 3;0 0 3;0 0 3]

A = 3×3

     0     0     3
     0     0     3
     0     0     3

Eseguire test sulle righe di A per gli elementi diversi da zero, specificando dim = 2.

B = any(A,2)

B = 3×1 logical array

   1
   1
   1

Elementi diversi da zero nella pagina dell'array

Creare un array tridimensionale e determinare se sono presenti elementi diversi da zero in ciascuna pagina di dati (righe e colonne).

A(:,:,1) = [2 0; 0 0];
A(:,:,2) = [0 0; 0 0];
A(:,:,3) = [0 0; 0 1];
B = any(A,[1 2])

B = 1×1×3 logical array
B(:,:,1) =

   1


B(:,:,2) =

   0


B(:,:,3) =

   1

Argomenti di input

A — Array di input

scalare | vettore | matrice | array multidimensionale

Array di input, specificato come scalare, vettore, matrice o array multidimensionale. La funzione any ignora gli elementi di A che sono NaN ((Not a Number) Non un numero).

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Supporto numeri complessi: Sì

dim — Dimensione lungo la quale operare

scalare intero positivo

Dimensione lungo la quale operare, specificata come scalare intero positivo. Se non si specifica la dimensione, per impostazione predefinita si considera la prima dimensione dell'array la cui grandezza non è uguale a 1.

Considerare un array di input a due dimensioni, A:

• any(A,1) opera sugli elementi successivi nelle colonne di A e restituisce un vettore riga di valori logici.

• any(A,2) opera sugli elementi successivi nelle righe di A e restituisce un vettore colonna di valori logici.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

vecdim — Vettore di dimensioni

vettore di numeri interi positivi

Vettore di dimensioni, specificato come vettore di numeri interi positivi. Ciascun elemento rappresenta una dimensione dell'array di input. Le lunghezze dell’output nelle dimensioni operative specificate sono 1, mentre le altre rimangono invariate.

Considerare un array di input 2x3x3, A. Quindi any(A,[1 2]) restituisce un array 1x1x3 i cui elementi indicano valori diversi da zero per ciascuna pagina di A.

Tipi di dati: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argomenti di output

B — Array logico

scalare | vettore | matrice | array multidimensionale

Array logico, restituito come scalare, vettore, matrice o array multidimensionale. La dimensione di A su cui opera any ha grandezza 1 in B.

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione any supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Per l'argomento di input A:

  • Se non si specifica una dimensione, il generatore di codice opera lungo la prima dimensione dell'array di input che ha grandezza variabile o la cui grandezza non è uguale a 1. Se questa dimensione ha grandezza variabile al momento della generazione di codice ed è pari a 1 in fase di esecuzione, può verificarsi un errore di runtime. Per evitare il verificarsi di tale errore, specificare la dimensione.

  • Se tutte le dimensioni dell'array input hanno grandezza variabile al momento della generazione di codice, questo array non può essere vuoto in fase di esecuzione.

• Se utilizzato, l'argomento dim deve essere costante al momento della generazione di codice.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Consultare le note su utilizzo e limitazioni nella sezione Generazione di codice C/C++. Le stesse note su utilizzo e limitazioni si applicano alla generazione di codice GPU.

Generazione di codice HDL

Genera codice VHDL, Verilog e SystemVerilog per progetti FPGA e ASIC utilizzando HDL Coder™.

I tipi di dato double non sono supportati.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

La funzione any supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione any supporta completamente gli array di GPU. Per eseguire la funzione su una GPU, specificare i dati di input come un gpuArray (Parallel Computing Toolbox). Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

La funzione any supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

all | colon | or | prod | sum | nnz

Argomenti

• Reduce Logical Arrays to Single Value