size

Tamaño de un arreglo

Sintaxis

sz = size(A)

szdim = size(A,dim)

szdim = size(A,dim1,dim2,...,dimN)

[sz1,...,szN] = size(___)

Descripción

sz = size(A) devuelve un vector fila cuyos elementos son las longitudes de las dimensiones correspondientes de A. Por ejemplo, si A es una matriz de 3 por 4, size(A) devuelve el vector [3 4].

Si A es una tabla o un horario, size(A) devuelve un vector fila de dos elementos que consiste en el número de filas y el número de variables de tabla.

szdim = size(A,dim) devuelve la longitud de la dimensión dim cuando dim es un escalar entero positivo. También puede especificar dim como vector de enteros positivos para consultar múltiples longitudes de dimensiones al mismo tiempo. Por ejemplo, size(A,[2 3]) devuelve las longitudes de la segunda y la tercera dimensión de A en el vector fila de 1 por 2 szdim.

szdim = size(A,dim1,dim2,...,dimN) devuelve las longitudes de las dimensiones dim1,dim2,...,dimN en el vector fila szdim.

[sz1,...,szN] = size(___) devuelve las longitudes de las dimensiones consultadas de A por separado.

Ejemplos

Tamaño de un arreglo 4D

Cree un arreglo 4D aleatorio y devuelva su tamaño.

A = rand(2,3,4,5);
sz = size(A)

sz = 1×4

     2     3     4     5

Consulte la longitud de la segunda dimensión de A.

szdim2 = size(A,2)

szdim2 = 
3

Consulte la longitud de la última dimensión de A.

szdimlast = size(A,ndims(A))

szdimlast = 
5

Puede consultar múltiples longitudes de dimensión al mismo tiempo especificando un argumento de dimensión de vector. Por ejemplo, encuentre las longitudes de la primera y la tercera dimensión de A.

szdim13 = size(A,[1 3])

szdim13 = 1×2

     2     4

Encuentre las longitudes de la segunda a la cuarta dimensión de A.

szdim23 = size(A,2:4)

szdim23 = 1×3

     3     4     5

De forma alternativa, puede listar las dimensiones consultadas como argumentos de entrada separados.

szdim23 = size(A,2,3,4);

Tamaño de tabla

Cree una tabla con 5 filas y 4 variables.

LastName = {'Smith';'Johnson';'Williams';'Jones';'Brown'};
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

A = table(Age,Height,Weight,BloodPressure,'RowNames',LastName)

A=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80  

Encuentre el tamaño de la tabla. Aunque la variable BloodPressure contiene dos columnas, size solo cuenta el número de variables.

sz = size(A)

sz = 1×2

     5     4

Longitudes de dimensiones como argumentos separados

Cree una matriz aleatoria y devuelva el número de filas y columnas por separado.

A = rand(4,3);
[numRows,numCols] = size(A)

numRows = 
4

numCols = 
3

Argumentos de entrada

A — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | function_handle | cell | categorical | datetime | duration | calendarDuration | table | timetable

Soporte de números complejos: Sí

dim — Dimensiones consultadas

escalar entero positivo | vector de escalares enteros positivos | arreglo vacío

Dimensiones consultadas, especificadas como escalar entero positivo, vector de escalares enteros positivos o arreglo vacío de tamaño 0 por 0, 0 por 1 o 1 por 0. Si un elemento de dim es más grande que ndims(A), size devuelve 1 en el elemento correspondiente de la salida. Si dim es un arreglo vacío, size devuelve un arreglo vacío de 1 por 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

dim1,dim2,...,dimN — Lista de dimensiones consultadas

escalares enteros positivos

Lista de dimensiones consultadas, especificadas como escalares enteros positivos separados por comas. Si un elemento de la lista es más grande que ndims(A), size devuelve 1 en el elemento correspondiente de la salida.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Argumentos de salida

sz — Tamaño de arreglo

vector fila de enteros no negativos

Tamaño de arreglo, devuelto como vector fila de enteros no negativos.

• Cada elemento de sz representa la longitud de la dimensión correspondiente de A. Si cualquier elemento de sz es igual a 0, A es un arreglo vacío.

• Si A es un escalar, sz es el vector fila [1 1].

• Si A es una tabla o un horario, sz es un vector fila de dos elementos que contiene el número de filas y el número de variables. Si hay múltiples columnas en una única variable, no se cuentan.

• Si A es un vector de caracteres de tipo char, size devuelve el vector fila [1 M], en el que M es el número de caracteres. Sin embargo, si A es un escalar de cadena, size devuelve [1 1] porque es un único elemento de un arreglo de cadena. Por ejemplo, compare la salida de size de un vector de caracteres y una cadena:

  szchar = size('mytext')

  szchar =
  
       1     6

  szstr = size("mytext")

  szstr =
  
       1     1
  

  Para encontrar el número de caracteres de una cadena, utilice la función strlength.

Tipos de datos: double

szdim — Longitudes de dimensiones

escalar entero no negativo | vector de escalares enteros no negativos | arreglo vacío de 1 por 0

Longitudes de dimensiones, devueltas como escalar entero no negativo cuando dim es un escalar entero positivo, como vector fila de escalares enteros no negativos cuando dim es un vector de enteros positivos o como arreglo vacío de 1 por 0 cuando dim es un arreglo vacío. Si un elemento del argumento de dimensión especificado es más grande que ndims(A), size devuelve 1 en el elemento correspondiente de szdim.

Tipos de datos: double

sz1,...,szN — Longitudes de dimensiones enumeradas por separado

escalares enteros no negativos

Longitudes de dimensiones enumeradas por separado, devueltas como escalares enteros no negativos separados por comas.

• Cuando no se especifica dim y se enumeran menos de ndims(A) argumentos de salida, todas las demás longitudes de dimensiones se contraen en el último argumento en la lista. Por ejemplo, si A es un arreglo 3D con el tamaño [3 4 5], [sz1,sz2] = size(A) devuelve sz1 = 3 y sz2 = 20.

• Cuando se especifica dim, el número de argumentos de salida debe ser igual al número de dimensiones consultadas.

• Si especifica más de ndims(A) argumentos de salida, los argumentos posteriores adicionales se devuelven como 1.

Tipos de datos: double

Sugerencias

• Para determinar si un arreglo está vacío o es un escalar o una matriz, utilice las funciones isempty, isscalar y ismatrix. También puede determinar la orientación de un vector con las funciones isrow e iscolumn.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función size es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Para arreglos ND de tamaño variable, la función size puede devolver en el código generado un resultado distinto al de MATLAB^®. Consulte Incompatibility with MATLAB in Determining Size of Variable-Size N-D Arrays (MATLAB Coder).

Generación de código de GPU
Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Generación de código HDL
Genere código VHDL, Verilog y SystemVerilog para diseños FPGA y ASIC mediante HDL Coder™.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función size es totalmente compatible con los arreglos de GPU. Para ejecutar la función en una GPU, especifique los datos de entrada como un gpuArray (Parallel Computing Toolbox). Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2019b: Especificar dimensiones como vector de enteros positivos o argumentos de entrada separados

Puede especificar dim como vector de enteros positivos para consultar múltiples longitudes de dimensiones al mismo tiempo. De forma alternativa, puede listar las dimensiones consultadas como argumentos de entrada separados dim1,dim2,...,dimN. Para ver un ejemplo, consulte Tamaño de un arreglo 4D.

Consulte también

length | strlength | ndims | numel | height | width