times — Multiply arrays element by element.
times(A, B) and A .* B multiply compatible numeric, logical, character, sparse, symbolic, or provider-resident operands using implicit expansion.
Syntax
C = times(A, B)
C = times(A, B, "like", prototype)Inputs
A- Type
Any- Required
- Yes
- Description
- First numeric, logical, character, symbolic, sparse, or provider-resident operand.
B- Type
Any- Required
- Yes
- Description
- Second operand with a size compatible for implicit expansion.
like- Type
StringScalar- Required
- Yes
- Description
- Literal `like` selector for the RunMat output-prototype extension.
prototype- Type
LikePrototype- Required
- Yes
- Description
- Host, device, real, or complex output prototype.
Returns
C- Type
NumericArray- Description
- Element-wise result with the broadcasted operand shape.
Errors
RunMat:times:TooManyOutputs- When
- More than one output is requested.
- Message
times: too many output arguments
RunMat:times:InvalidArgument- When
- Optional arguments are malformed or unsupported.
- Message
times: invalid argument
RunMat:times:InvalidInput- When
- Operands or prototypes cannot be converted into supported numeric or symbolic forms.
- Message
times: invalid input
Element-wise multiplication and implicit expansion
times(A, B) and A .* B multiply corresponding elements. Singleton dimensions expand when the remaining extents are compatible; incompatible dimensions produce a size-mismatch error, and compatible empty dimensions remain empty.
Real and complex operands may be combined. Character inputs contribute their Unicode code points and logical inputs contribute zero or one. String arrays are not numeric and are rejected.
Numeric classes and sparse storage
Double inputs produce double. An operation involving single floating-point data produces single. Fixed-width integer multiplication accepts matching integer classes or one integer operand with scalar double, preserves the integer class, rounds according to the integer arithmetic contract, and saturates at the class bounds.
Sparse-sparse, sparse-scalar, and compatible dense products retain real sparse storage when the mathematical result remains sparse. Complex products use full complex storage because complex sparse storage is not currently available.
Accelerated execution and output prototypes
Matching provider-resident operands use element-wise multiplication when available; scalar multiplication and provider-side expansion keep supported work resident. Unsupported forms gather through the owning provider and use the same host rules.
RunMat mode accepts times(A, B, 'like', prototype). The prototype controls host or provider residency and may request complex output. MATLAB compatibility mode rejects this extension.
Examples
Multiply two matrices element by element
A = [1 2 3; 4 5 6];
B = [7 8 9; 1 2 3];
P = times(A, B)Expected output:
P = [7 16 27; 4 10 18]Scale an array
A = [8 1 6; 3 5 7; 4 9 2];
scaled = times(A, 0.5)Expected output:
scaled = [4 0.5 3; 1.5 2.5 3.5; 2 4.5 1]Expand a column and row
col = (1:3)';
row = [10 20 30];
P = times(col, row)Expected output:
P = [10 20 30; 20 40 60; 30 60 90]Multiply complex values
z1 = [1+2i, 3-4i];
z2 = [2-1i, -1+1i];
P = times(z1, z2)Expected output:
P = [4+3i 1+7i]Multiply character code points
codes = times('ABC', 2)Expected output:
codes = [130 132 134]Multiply provider-resident arrays
G1 = gpuArray(single([1 2 3]));
G2 = gpuArray(single([4 5 6]));
deviceProduct = times(G1, G2);
P = gather(deviceProduct)Expected output:
P = single([4 10 18])Request a provider-resident product
A = [1 2 3];
B = [4 5 6];
prototype = gpuArray(0);
deviceProduct = times(A, B, 'like', prototype);
P = gather(deviceProduct)Expected output:
P = [4 10 18]Using times with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how times changes the result.
Run a small times example, explain the result, then change one input and compare the output.
FAQ
Does times use implicit expansion?⌄
Yes. Singleton dimensions expand when every non-singleton extent is compatible.
What class does times return?⌄
Floating arithmetic follows the participating floating class rules. Supported integer arithmetic preserves the integer class. Logical and character inputs produce numeric output.
How does integer overflow behave?⌄
Fixed-width integer products saturate at the minimum or maximum of their class.
Can I multiply provider-resident arrays and host scalars?⌄
Yes. RunMat keeps supported scalar multiplication on the provider and otherwise follows the owner-aware fallback path.
How do I request a provider-resident result?⌄
In RunMat mode, pass 'like' and a provider-resident prototype.
What happens with empty arrays?⌄
Compatible empty dimensions propagate into the broadcasted output shape.
Can times combine real and complex operands?⌄
Yes. The result is complex and uses the same implicit-expansion rules.
Does times preserve sparse matrices?⌄
Real sparse storage is retained when the mathematical result remains sparse. Complex products currently use full complex storage.
Does times accept string arrays?⌄
No. String arrays are not numeric multiplication operands.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · hypot · imag · int16 · int32 · int64 · int8 · intmax · intmin · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · realmax · realmin · realsqrt · rescale · sign · single · sqrt · typecast · uint16 · uint32 · uint64 · uint8
Optim
acceptancesa · annealingboltz · annealingfast · coneprog · crossoverarithmetic · crossoverheuristic · crossoverintermediate · crossoverlaplace · crossoverscattered · crossoversinglepoint · crossovertwopoint · eqnproblem · EquationProblem.solve · EquationProblem.subsasgn · EquationProblem.subsref · evaluate · fgoalattain · fitscalingprop · fitscalingrank · fitscalingshiftlinear · fitscalingtop · fminbnd · fmincon · fminimax · fminsearch · fminunc · fseminf · fsolve · fzero · ga · gacreationlinearfeasible · gacreationnonlinearfeasible · gacreationsobol · gacreationuniform · gacreationuniformint · gaplotbestf · gaplotbestindiv · gaplotdistance · gaplotexpectation · gaplotgenealogy · gaplotmaxconstr · gaplotrange · gaplotscorediversity · gaplotscores · gaplotselection · gaplotstopping · integerConstraint · integral · intlinprog · linprog · lsqcurvefit · lsqlin · LsqlinWarmStart.subsasgn · LsqlinWarmStart.subsref · lsqnonlin · lsqnonneg · mutationadaptfeasible · mutationgaussian · mutationpositivebasis · mutationpower · mutationuniform · optimexpr · optimget · OptimizationConstraint.evaluate · OptimizationConstraint.subsasgn · OptimizationConstraint.subsref · OptimizationExitflag.double · OptimizationExitflag.eq · OptimizationExitflag.ne · OptimizationExitflag.string · OptimizationExpression.acos · OptimizationExpression.acosh · OptimizationExpression.acot · OptimizationExpression.acoth · OptimizationExpression.acsc · OptimizationExpression.acsch · OptimizationExpression.asec · OptimizationExpression.asech · OptimizationExpression.asin · OptimizationExpression.asinh · OptimizationExpression.atan · OptimizationExpression.atanh · OptimizationExpression.cat · OptimizationExpression.cos · OptimizationExpression.cosh · OptimizationExpression.cot · OptimizationExpression.coth · OptimizationExpression.csc · OptimizationExpression.csch · OptimizationExpression.ctranspose · OptimizationExpression.cumprod · OptimizationExpression.cumsum · OptimizationExpression.diag · OptimizationExpression.diff · OptimizationExpression.dot · OptimizationExpression.eq · OptimizationExpression.evaluate · OptimizationExpression.exp · OptimizationExpression.ge · OptimizationExpression.horzcat · OptimizationExpression.ldivide · OptimizationExpression.le · OptimizationExpression.log · OptimizationExpression.mean · OptimizationExpression.minus · OptimizationExpression.mldivide · OptimizationExpression.mpower · OptimizationExpression.mrdivide · OptimizationExpression.mtimes · OptimizationExpression.norm · OptimizationExpression.plus · OptimizationExpression.power · OptimizationExpression.prod · OptimizationExpression.rdivide · OptimizationExpression.reshape · OptimizationExpression.sec · OptimizationExpression.sech · OptimizationExpression.sin · OptimizationExpression.sinh · OptimizationExpression.sqrt · OptimizationExpression.subsasgn · OptimizationExpression.subsref · OptimizationExpression.sum · OptimizationExpression.tan · OptimizationExpression.tanh · OptimizationExpression.times · OptimizationExpression.trace · OptimizationExpression.transpose · OptimizationExpression.uminus · OptimizationExpression.uplus · OptimizationExpression.vertcat · OptimizationExpression.zeros · OptimizationExpression.zerosLike · OptimizationProblem.solve · OptimizationProblem.subsasgn · OptimizationProblem.subsref · OptimizationVariable.subsasgn · OptimizationVariable.subsref · optimoptions · optimplotconstrviolation · optimplotfirstorderopt · optimplotfunccount · optimplotfval · optimplotfvalconstr · optimplotmilp · optimplotstepsize · optimplotx · optimproblem · optimset · optimvar · optimwarmstart · particleswarm · patternsearch · psplotbestf · psplotbestx · psplotfuncount · psplotmaxconstr · psplotmeshsize · pswcreationuniform · pswplotbestf · quad · quadprog · QuadprogWarmStart.subsasgn · QuadprogWarmStart.subsref · saplotbestf · saplotbestx · saplotf · saplotstopping · saplottemperature · saplotx · savemilpsolutions · secondordercone · selectionremainder · selectionroulette · selectionstochunif · selectiontournament · selectionuniform · simulannealbnd · solve · surrogateopt · surrogateoptplot · temperatureboltz · temperatureexp · temperaturefast
Trigonometry
acos · acosd · acosh · acotd · acscd · asecd · asin · asind · asinh · atan · atan2 · atan2d · atand · atanh · cos · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · sin · sind · sinh · sinpi · tan · tand · tanh
Reduction
all · any · bounds · cummax · cummin · cumprod · cumsum · cumtrapz · diff · gradient · max · maxk · mean · median · min · mink · movmax · movmean · movmedian · movmin · movprod · movstd · movsum · movvar · nnz · prod · rms · std · sum · trapz · var
Structure
bandwidth · isdiag · ishermitian · issymmetric · istril · istriu · symrcm
Signal
blackman · butter · buttord · cheb2ord · conv · conv2 · deconv · downsample · envelope · filter · filtfilt · fir1 · freqz · gauspuls · hamming · hann · hilbert · periodogram · pulstran · pwelch · rectpuls · resample · sawtooth · sinc · spectrogram · square · tripuls · unwrap · upsample · zplane
Factor
chol · decomposition · decomposition.ctranspose · decomposition.mldivide · decomposition.mrdivide · decomposition.mtimes · decomposition.rdivide · decomposition.subsref · decomposition.times · decomposition.uminus · decomposition.uplus · eig · eigs · gmres · ichol · ilu · lu · ordeig · ordqz · ordschur · pcg · qr · qz · rsf2csf · schur · svd
Ops
cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose
Interpolation
griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline
Integer Division
Source you can read
Every RunMat function's source is public. Read exactly how times is executed, line by line, in Rust.
- View the source for times in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.