int32 — Convert supported values to signed 32-bit integer storage.
int32(X) performs shape-preserving, rounded, saturating conversion to native signed 32-bit storage.
Syntax
Y = int32(X)Inputs
X- Type
Any- Required
- Yes
- Default
- —
- Description
- Input scalar or array value to convert.
Returns
Y- Type
NumericArray- Description
- int32-converted output value.
Errors
RunMat:int32:InvalidArgument- When
- The call has an unsupported number of input arguments or requests more than one output.
- Message
int32: invalid argument
RunMat:int32:InvalidInput- When
- Input cannot be converted to int32.
- Message
int32: invalid input
RunMat:int32:Internal- When
- Internal conversion, gather, or provider upload fails.
- Message
int32: internal error
Behavior
Y = int32(X) converts supported values to native int32 storage and preserves every array dimension. The class range is -2,147,483,648 through 2,147,483,647.
Finite fractional values round to the nearest integer with halfway cases away from zero, then saturate to the target range. Negative values saturate to zero for unsigned classes. Positive and negative infinity saturate at the corresponding boundary, and NaN becomes zero.
Every fixed-width integer input converts directly from authoritative native storage without passing through binary64. Logical values become zero or one, characters become Unicode code points, and real sparse input retains CSC structure with native integer stored values.
Real and dense complex numeric, logical, character, symbolic-constant, real sparse, and supported gpuArray input is accepted. Dense complex values convert both components and remain complex even when the converted imaginary component is zero. Complex sparse storage is unsupported and returns a typed conversion error without materializing or discarding its imaginary component. String, cell, struct, object, handle, and nonconstant symbolic input also returns a typed conversion error.
The call returns one output. A statement or discarded output still executes conversion; requesting more than one output is rejected before operand preparation or provider access.
GPU execution
Supported providers convert real resident input directly to native int32 storage and retain the owning provider and shape.
When a provider lacks the typed conversion hook, RunMat gathers through the exact owner, applies the same saturating conversion to authoritative host storage, and restores a resident result when representable. It never labels a floating buffer as an integer class.
Examples
Round and saturate values at the class boundaries
values = int32([-Inf -1.5 0 1.5 Inf])Expected output:
values = int32([-2147483648 -2 0 2 2147483647])Preserve matrix shape in native integer storage
A = [1 2; 3 4];
Y = int32(A)Expected output:
Y is a 2-by-2 int32 matrixConvert provider-resident values to native integer storage
G = gpuArray([-2 0; 1 3]);
Y = int32(G);
host = gather(Y)Expected output:
host is a 2-by-2 int32 matrixUsing int32 with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how int32 changes the result.
Run a small int32 example, explain the result, then change one input and compare the output.
FAQ
Does int32 preserve array shape?⌄
Yes. Every dimension is retained while the stored numeric class becomes int32.
How are out-of-range and fractional values handled?⌄
Values round to the nearest integer with halfway cases away from zero and then saturate at the target boundary.
Does conversion pass integers through floating point?⌄
No. Fixed-width integer input converts directly from its authoritative native storage, including exact 64-bit values.
What happens to complex input?⌄
Both components convert independently to int32, and the result retains complex storage even when one converted component is zero.
What happens to sparse input?⌄
Real sparse input retains CSC structure and converts its stored values to native int32 storage.
Will gpuArray input remain resident?⌄
Yes when the owning provider supports native integer storage or the typed owner-aware fallback can restore the result.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · hypot · imag · int16 · int64 · int8 · intmax · intmin · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · realmax · realmin · realsqrt · rescale · sign · single · sqrt · times · 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 int32 is executed, line by line, in Rust.
- View the source for int32 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.