.. highlightlang:: us

.. index:: nc_dimredim

.. _nc_dimredim:

nc_dimredim
===========

.. us.tag  nc_dimredim ENGLISH NC_Dim New5100

:ref:`nc_dimredim` modifies the size of a dimension. The NC2 file must be set
to define mode (see :ref:`nc_endef`/:ref:`nc_redef`).

.. function::  ret = nc_dimredim(ncid, dimid, nNewSize)

.. us.return

**Return Value**

If the function succeeds, the return value is not equal to -1. If the function
fails, the return value is -1.

.. us.params

**Parameters**

.. uparam:: ncid

   Identifies the netCDF file.

.. uparam:: dimid

.. uparam:: nNewSize

   *nSize* is the new size of the dimension.

.. us.comment

**Comment**

The NC2 file must be in define mode. Only available for UniPlot data files (NC2).

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.10.0
     - New.

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`nc_redef`,
   :ref:`nc_dimdef`,
   :ref:`nc_dimid`,
   :ref:`nc_create`

:sub:`id-842514`