mustBeNonsparse

Validate that value is nonsparse or issue error

Syntax

mustBeNonsparse(value)

Description

mustBeNonsparse(value) issues an error if value is sparse. This function does not return a value.

mustBeNonsparse accepts user-defined objects if the class of the object implements this method:

• issparse

Examples

Validate Input Is Not Sparse

Use mustBeNonsparse to validate that the input is nonsparse.

Use the sparse function to create a sparse matrix.

A = [ 0   0   0   5
      0   2   0   0
      1   3   0   0
      0   0   4   0];
S = sparse(A);

Validate that S is nonsparse.

mustBeNonsparse(S)

Error using mustBeNonsparse (line 13)
Values must not be sparse.

Restrict Property Values

This class restricts the value of Prop1 to nonsparse values.

classdef MyClass
   properties
      Prop1 {mustBeNonsparse}
   end
end

Create an object and assign a value to its property.

obj = MyClass;
A = [ 0   0   0   5
      0   2   0   0
      1   3   0   0
      0   0   4   0];
obj.Prop1 = sparse(A);

Error setting 'Prop1' property of 'MyClass' class:
Values must not be sparse.

When you assign a value to the property, MATLAB^® calls mustBeNonsparse with the value being assigned to the property. mustBeNonsparse issues an error because the value assigned to Prop1 is sparse.

Restrict Function Argument Values

This function restricts the input argument to be any nonsparse value.

function mbNonsparse(S)
    arguments
        S {mustBeNonsparse}
    end
    disp(S)
end

Calling this function with a sparse array results in an error being thrown by mustBeNonsparse.

A = [ 0   0   0   5
      0   2   0   0
      1   3   0   0
      0   0   4   0];
S = sparse(A);
mbNonsparse(S)

Error using mbNonsparse
Invalid input argument at position 1. Value must not be sparse.

Input Arguments

value — Value to validate

scalar | array

Value to validate, specified as a scalar or array of any one of the following:

• logical or numeric class

• MATLAB classes that implement issparse

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Complex Number Support: Yes

Extended Capabilities

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