.. highlightlang:: us

.. _xygetnumberofpoints:

XYGetNumberOfPoints
===================

.. index:: XYGetNumberOfPoints

.. us.tag  XYGetNumberOfPoints ENGLISH xy.data

:ref:`XYGetNumberOfPoints` returns the number of data points of a 2D dataset.

.. function::  nPoints = XYGetNumberOfPoints(hData)
    nPoints = XYGetNumberOfPoints(hData, bExt)

.. us.return

**Return Value**

*nPoints* is the number of data points. If *bExt* is 1 but the dataset contains
no filtered data the return value is 0.

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYCreate` or
   :ref:`TYCreate`.

.. uparam:: bExt

   This parameter specifies if the function will access the original data
   or the filtered data.

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

      * - Value
        - Description
      * - -1
        - If filtered data is available it will access filtered data, otherwise it will  access original data. Default value is -1.
      * - 0
        - Access original data.
      * - 1
        - Access filtered data.

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYCreate`,
   :ref:`XYGetData`,
   :ref:`XYGetGetOrgDataFlag`,
   :ref:`XYIsMarkerOrgData`

:sub:`id-662557`