isgpuarray

Determine whether input is gpuArray

Syntax

TF = isgpuarray(X)

Description

TF = isgpuarray(X) returns logical 1 (true) if X is a gpuArray, and logical 0 (false) otherwise. You can use this function with an if statement to avoid executing code that expects gpuArray input.

Examples

Determine if Array is gpuArray

Create an array of random numbers.

X = rand(3,3);

Copy the array onto the GPU.

Y = gpuArray(X);

Use the function isgpuArray to verify that Y is a gpuArray.

isgpuArray(Y)

ans = 
   1

Verify that X is not a gpuArray.

isgpuarray(X)

ans = 
   0

Input Arguments

X — Input variable

workspace variable

Input variable, specified as a workspace variable. X can be any data type.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

This function fully supports GPU arrays. For more information, see Run MATLAB Functions on a GPU.

Version History

Introduced in R2020b