.. highlightlang:: us

.. index:: NC_DeleteFilteredRecords

.. _NC_DeleteFilteredRecords:

NC_DeleteFilteredRecords
========================

.. us.tag  NC_DeleteFilteredRecords ENGLISH nc.tools New5509

:ref:`NC_DeleteFilteredRecords` remove all filtered records from the given NC 
file.

.. function::  bool = NC_DeleteFilteredRecords(ncid)

.. us.return

**Return Value**

**Returnwert**

TRUE if the funtion was successful.

.. us.params

**Parameters**

.. uparam:: ncid

   *ncid* is the handle of an NC file, returned by 
   :ref:`nc_create` or :ref:`nc_open`.

.. us.example

**Example**

::

   def _NC_Remove(ssFile, ssFilter)
   {
      ssNCFile = auto_ImportData(ssFile);
      if (ssNCFile == "") {
         return FALSE;
      }
      if (auto_SetFilter(ssFilter, ssNCFile) == FALSE) {
         MessageBoxWarning("Cannot set filter");
         return FALSE;
      }

      ncid = nc_open(ssNCFile, NC_WRITE);
      if (ncid == -1) {
         return FALSE;
      }
      bRet = NC_DeleteFilteredRecords(ncid);
      nc_close(ncid);
      _NC_Pack(ssNCFile); // internal function
   }

   _NC_Remove("d:/a.nc2", "$time$ > 2 && $time$ < 10")

.. us.history

**History**

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

   * - Version
     - Description
   * - R2013.9
     - New.

.. seealso::
   :ref:`overview-netcdf-files`,
   :ref:`auto_ImportData`,
   :ref:`nc_open`,
   :ref:`auto_SetFilter`

:sub:`id-2024581`