.. highlightlang:: us

.. index:: nc_inquire_ndims

.. _nc_inquire_ndims:

nc_inquire_ndims
================

.. us.tag  nc_inquire_ndims ENGLISH NC

:ref:`nc_inquire_ndims` returns the number of dimensions in a nc file.

.. function::  ndims = nc_inquire_ndims(ncid)

.. us.return

**Return Value**

If the function succeeds, the return value is the number of dimensions. If the
function fails, the return value is -1.

.. us.params

**Parameters**

.. uparam:: ncid

   Identifies the nc file.

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`nc_create`

:sub:`id-274444`