dotListLength

Class: matlab.mixin.indexing.RedefinesDot
Namespace: matlab.mixin.indexing

Determine number of values to return from customized indexing operations beginning with dots

Since R2021b

Syntax

n = dotListLength(obj,indexOp,indexContext)


Description

n = dotListLength(obj,indexOp,indexContext) determines the number of values to return from customized indexing operations that begin with dots and that reference or assign to comma-separated lists. Operations that begin with dot indexing and end with dot or brace indexing produce comma-separated lists, such as [C{:}] = obj{1:3} and [obj{1}.prop{1:3}] = B{:}. The indexOp object contains the indices being changed, and indexContext identifies whether the reference is used in a statement, as a list of arguments to a function, or in an assignment operation.

Input Arguments

obj — Object that implements customized dot indexing

object

Object that implements customized dot indexing by inheriting from matlab.mixin.indexing.RedefinesDot.

indexOp — Types of indexing operations and indices referenced

array of IndexingOperation objects

Types of indexing operations and indices referenced, specified as an array of IndexingOperation objects. For a dot reference, the first object in the array has a Type property of Dot.

indexContext — Context in which indexing operation occurs

matlab.indexing.IndexingContext object

Context in which the indexing operation occurs, specified as one of these enumeration members:

• matlab.indexing.IndexingContext.Statement — Indexed reference used as a statement (for example, obj.a)

• matlab.indexing.IndexingContext.Expression — Indexed reference used as an argument to a function (for example, func(obj.a))

• matlab.indexing.IndexingContext.Assignment — Indexed assignment (for example, [obj.a] = deal(x)).

Output Arguments

n — Number of values to return from indexing operation

nonnegative integer

Number of values to return from an indexing operation, specified as a nonnegative integer.

Attributes

Access	protected
Abstract	true

To learn about attributes of methods, see Method Attributes.

Examples

For an example of a scalar struct class that implements custom dot indexing, see matlab.mixin.indexing.RedefinesDot.

Version History

Introduced in R2021b