# `length`

The “length” of a object (heuristic complexity)

MuPAD® notebooks will be removed in a future release. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.

## Syntax

```length(`object`)
```

## Description

`length(object)` returns an integer indicating the complexity of the object.

The (heuristic) complexity of an object may be useful in algorithms that need to predict the complexity and time for manipulating objects. E.g., a symbolic Gaussian algorithm for solving linear equations prefers Pivot elements of small complexity.

The length of an object is determined as follows:

`length()` yields 0.

### Note

`length` does not return the number of elements or entries in sets, lists or tables. Use `nops` instead!

## Examples

### Example 1

Intuitively, the length measures the complexity of an object:

`length(1 + x) < length(x^3 + exp(a - b)/ln(45 - t) - 1234*I)`
` `

### Example 2

We compute the lengths of some simple objects:

`length(1.2), length(-1234.5), length(123456), length(-123456)`
` `
`length(17), length(123), length(17/123)`
` `
`length(12), length(123), length(12 + 123*I)`
` `
`length(x), length(x^2), length(x^12345)`
` `
`length("123"), length("")`
` `
`length(x), length(a_long_name)`
` `

### Example 3

The length of an array is the sum of the lengths of all its elements plus 1:

`A := array(1..2, [x, y]): length(A) = length(x) + length(y) + 1`
` `
`A := 12345: length(A) = length(12345) + length(y) + 1`
` `
```A := hfarray(1..10, [1.0 \$ 10]): length(A) = 10*length(1.0) + 1```
` `
```A := hfarray(1..10, [1.0 + 2.0*I \$ 10]): length(A) = 10*length(1.0 + 2.0*I) + 1```
` `

Beware: If only one complex number is contained in an hfarray, then all entries are regarded as complex numbers, even if they are real:

```A := hfarray(1..10, [2.0 \$ 9, 2.0 + 3.0*I]): length(A) = 10*length(2.0 + 3.0*I) + 1```
` `
`delete A:`

### Example 4

The operands of a table are the equations associating indices and entries. The length of each operand is the length of the index plus the length of the corresponding entry plus 1:

`T := 45: T`
` `
`length(T) = length(1 = 45) + 1`
` `
`delete T:`

## Parameters

 `object` An arbitrary MuPAD® object

## Return Values

Nonnegative integer.