.. highlightlang:: us

.. _nc_setfill:

nc_setfill
==========

.. index:: nc_setfill

.. us.tag  nc_setfill ENGLISH NC

:ref:`nc_setfill` determines whether
or not variable prefilling will be done.

.. function::  ncold = nc_setfill(ncid, fillmode)

.. us.return

**Return Value**

If the function succeeds, the return value is the old
fillmode (see *fillmode*).
If the function fails, the return value is -1.

.. us.params

**Parameters**

.. uparam:: fillmode

   *fillmode* is one of the following values:

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

   * - Value
     - Meaning
   * - NC_FILL
     - (default value) Enables prefilling.
   * - NC_NOFILL
     - Disables prefilling.

.. us.example

**Example**

::

   ncold = nc_setfill(ncid, NC_NOFILL);

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`nc_open`,
   :ref:`nc_close`

:sub:`id-1389986`