plus, +

Sumar números, añadir cadenas

Sintaxis

C = A + B

C = plus(A,B)

Descripción

C = A + B suma los arreglos A y B sumando los elementos correspondientes. Si una entrada es un arreglo de cadenas, entonces plus añade los elementos correspondientes como cadenas.

Los tamaños de A y B deben ser los mismos o ser compatibles. Si los tamaños de A y B son compatibles, los dos arreglos se amplían implícitamente para coincidir el uno con el otro. Por ejemplo, si A o B es un escalar, el escalar se combina con cada elemento del otro arreglo. Además, los vectores con distintas orientaciones (un vector fila y un vector columna) se amplían implícitamente para formar una matriz.

C = plus(A,B) es una forma alternativa de ejecutar A + B, pero se utiliza con poca frecuencia. Permite la sobrecarga de operadores para las clases.

Ejemplos

Sumar un escalar a un arreglo

Cree un arreglo, A, y súmele un valor escalar.

A = [0 1; 1 0];
C = A + 2

C = 2×2

     2     3
     3     2

El valor escalar se suma a cada entrada de A.

Añadir cadenas

Cree dos arreglos de cadenas de 1 por 3 y luego añada cadenas de ubicación similar a los arreglos.

s1 = ["Red" "Blue" "Green"]

s1 = 1×3 string
    "Red"    "Blue"    "Green"

s2 = ["Truck" "Sky" "Tree"]

s2 = 1×3 string
    "Truck"    "Sky"    "Tree"

s = s1 + s2

s = 1×3 string
    "RedTruck"    "BlueSky"    "GreenTree"

Sumar dos arreglos

Cree dos arreglos, A y B y súmelos.

A = [1 0; 2 4];
B = [5 9; 2 1];
C = A + B

C = 2×2

     6     9
     4     5

Los elementos de A se suman a los elementos correspondientes de B.

Sumar vectores fila y columna

Cree un vector fila de 1 por 2 y un vector columna de 3 por 1 y súmelos.

a = 1:2;
b = (1:3)';
a + b

ans = 3×2

     2     3
     3     4
     4     5

El resultado es una matriz de 3 por 2, donde cada elemento (i,j) de la matriz es igual a (j) + b(i):

$$\mathit{a}=\left[{\mathit{a}}_1{\mathit{a}}_2\right],\mathit{b}=\left[\begin{array}{c}{\mathit{b}}_1\\ {\mathit{b}}_2\\ {\mathit{b}}_3\end{array}\right],\mathit{a}+\mathit{b}=\left[\begin{array}{cc}{\mathit{a}}_1+{\mathit{b}}_1& {\mathit{a}}_2+{\mathit{b}}_1\\ {\mathit{a}}_1+{\mathit{b}}_2& {\mathit{a}}_2+{\mathit{b}}_2\\ {\mathit{a}}_1+{\mathit{b}}_3& {\mathit{a}}_2+{\mathit{b}}_3\end{array}\right].$$

Sumar un vector a una matriz

Cree un arreglo, A, y súmele un vector columna. El vector es tratado como si fuera una matriz del mismo tamaño que A, de modo que cada elemento en el vector se suma a una fila en A.

A = [1 2 3; 4 5 6]

A = 2×3

     1     2     3
     4     5     6

b = [10; 100]

b = 2×1

    10
   100

A + b

ans = 2×3

    11    12    13
   104   105   106

Añadir tablas

Desde la versión R2023a

Cree dos tablas y súmelas. Los nombres de las filas (si están presentes en ambas) y los nombres de las variables deben ser iguales, pero no necesitan estar en el mismo orden. Las filas y las variables de la salida están en el mismo orden que la primera entrada.

A = table([1;2],[3;4],VariableNames=["V1","V2"],RowNames=["R1","R2"])

A=2×2 table
          V1    V2
          __    __

    R1    1     3 
    R2    2     4 

B = table([4;2],[3;1],VariableNames=["V2","V1"],RowNames=["R2","R1"])

B=2×2 table
          V2    V1
          __    __

    R2    4     3 
    R1    2     1 

C = A + B

C=2×2 table
          V1    V2
          __    __

    R1    2     5 
    R2    5     8 

Argumentos de entrada

A, B — Operandos

escalares | vectores | matrices | arreglos multidimensionales | tablas | horarios

Operandos, especificados como escalares, vectores, matrices, arreglos multidimensionales, tablas u horarios. Las entradas A y B deben ser del mismo tamaño o tener tamaños compatibles (por ejemplo, A es una matriz M por N y B es un escalar o un vector fila 1 por N). Para obtener más información, consulte Tamaños de arreglos compatibles para operaciones básicas.

• Si una entrada es un arreglo de cadenas, entonces la otra entrada puede ser numérica, un carácter, cadena o arreglo de celdas. En este caso, plus convierte la entrada que no es cadena a un arreglo de cadenas y luego añade los elementos correspondientes de las entradas.

• Los operandos con un tipo de datos enteros no pueden ser complejos.

• Si una entrada es un arreglo datetime, un arreglo duration o un arreglo calendarDuration, los valores numéricos de la otra entrada se tratan como un número de días de 24 horas.

Las entradas que son tablas u horarios deben satisfacer estas condiciones: (desde R2023a)

• Si una entrada es una tabla o un horario, todas sus variables deben tener tipos de datos que admitan la operación.

• Si solo una entrada es una tabla u horario, la otra entrada debe ser un arreglo lógico o numérico.

• Si ambas entradas son tablas u horarios:

  • Ambas entradas deben tener el mismo tamaño, o bien una de ellas debe ser una tabla de una fila.

  • Ambas entradas deben tener variables con los mismos nombres. Sin embargo, las variables de cada entrada pueden estar en un orden diferente.

  • Si ambas entradas son tablas y ambas tienen nombres de filas, los nombres de sus filas deben ser los mismos. Sin embargo, los nombres de las filas de cada entrada pueden estar en un orden diferente.

  • Si ambas entradas son horarios, las horas de sus filas deben ser iguales. Sin embargo, las horas de las filas de cada entrada pueden estar en un orden diferente.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | datetime | duration | calendarDuration | table | timetable
Soporte de números complejos: Sí

Sugerencias

• Para añadir texto, plus solo opera en arreglos de cadenas. Utilice la función append para añadir texto en vectores de caracteres o arreglos de celdas.

Capacidades ampliadas

Arreglos altos

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

La función plus 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:

• Si utiliza plus con operandos de tipo simple y de tipo doble, es posible que el código generado no produzca el mismo resultado que MATLAB^®. Consulte Binary Element-Wise Operations with Single and Double Operands (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™.

Las entradas no pueden ser del tipo de datos logical.

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 plus 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

R2023a: Realizar operaciones directamente en tablas y horarios

El operador plus admite operaciones directamente en las tablas y en los horarios sin indexar para acceder a sus variables. Todas las variables deben tener tipos de datos que admitan la operación. Para obtener más información, consulte Direct Calculations on Tables and Timetables.

R2020b: El cambio en la ampliación implícita afecta a arreglos calendarDuration, datetime y duration

A partir de la versión R2020b, plus es compatible con la ampliación implícita cuando los argumentos son arreglos calendarDuration, datetime o duration. Entre las versiones R2020a y R2016b, la ampliación implícita solo era compatible para tipos de datos numéricos y de datos.

R2016b: El cambio en la ampliación implícita afecta a los argumentos para operadores

A partir de la versión R2016b con la incorporación de la ampliación implícita, algunas combinaciones de argumentos para operaciones básicas que anteriormente devolvían errores ahora generan resultados. Por ejemplo, anteriormente no podía añadir un vector fila y columna, pero ahora dichos operandos están disponibles para que se añadan. En otras palabras, una expresión como [1 2] + [1; 2] anteriormente devolvía un error de falta de coincidencia de tamaños, pero ahora se ejecuta.

Si su código utiliza operadores elemento por elemento y se basa en los errores que MATLAB devolvía anteriormente para tamaños que no coincidían, especialmente dentro de un bloque try/catch, es posible que su código deje de detectar esos errores.

Para obtener más información sobre los tamaños de entrada necesarios para operaciones básicas con arreglos, consulte Tamaños de arreglos compatibles para operaciones básicas.

Consulte también

minus | sum | cumsum | uplus | append

Temas

• Operaciones con matrices y operaciones con arreglos
• Precedencia de operadores
• Crear arreglos de cadenas
• Operadores y caracteres especiales de MATLAB