.. highlightlang:: us

.. index:: nc_sync

.. _nc_sync:

nc_sync
=======

.. us.tag  nc_sync ENGLISH NC_open New560

:ref:`nc_sync` writes all buffered data to the file.

.. function::  r = nc_sync(ncid)

.. 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 nc file.

.. us.comment

**Comment**

For UniPlot datafiles (updf-nc) all data since are buffered since the file was
opened or since the last call of :ref:`nc_sync`. :ref:`nc_abort` can be used to
discard all since the file was opened or since the last call of :ref:`nc_sync`.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.6.0
     - New.

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

:sub:`id-1926637`