MATLAB Function Reference |

**Syntax**

Note that the syntax for each of these three functions is the same; only the `xlim`

function is used for simplicity. Each operates on the respective x-, y-, or z-axis.

**Description**

```
xlim
```

with no arguments returns the respective limits of the current axes.

```
xlim([xmin xmax])
```

sets the axis limits in the current axes to the specified values.

```
xlim('mode')
```

returns the current value of the axis limits mode, which can be either `auto`

(the default) or `manual`

.

```
xlim('auto')
```

sets the axis limit mode to `auto`

.

```
xlim('manual')
```

sets the respective axis limit mode to `manual`

.

```
xlim(axes_handle,...)
```

performs the set or query on the axes identified by the first argument, `axes_handle`

. When you do not specify an axes handle, these functions operate on the current axes.

**Remarks**

`xlim`

, `ylim`

, and `zlim `

set or query values of the axes object `XLim`

, `YLim`

, `ZLim`

`, `

and `XLimMode`

, `YLimMode`

, `ZLimMode`

properties.

When the axis limit modes are `auto`

(the default), MATLAB uses limits that span the range of the data being displayed and are round numbers. Setting a value for any of the limits also sets the corresponding mode to `manual`

. Note that high-level plotting functions like `plot`

and `surf`

reset both the modes and the limits. If you set the limits on an existing graph and want to maintain these limits while adding more graphs, use the `hold`

command.

**Examples**

This example illustrates how to set the

- and *x*

-axis limits to match the actual range of the data, rather than the rounded values of*y*` [-2 3]`

for the

-axis and *x*`[-2 4]`

for the

-axis originally selected by MATLAB.*y*

[x,y] = meshgrid([-1.75:.2:3.25]); z = x.*exp(-x.^2-y.^2); surf(x,y,z) xlim([-1.75 3.25]) ylim([-1.75 3.25])

**See Also**

The axes properties `XLim`

, `YLim`

, `ZLim`

Setting the Aspect Ratio and Axis Limits for related functions

Understanding Axes Aspect Ratio for more information on how axis limits affect the axes.

xlabel, ylabel, zlabel | xlsfinfo |