.. highlightlang:: us

.. _xyzcopy:

XYZCopy
=======

.. index:: XYZCopy

.. us.tag  XYZCopy ENGLISH XYZSet New427

:ref:`XYZCopy` creates a copy of a 3D dataset.

.. function::  hDataNew = XYZCopy(hData)
    hDataNew = XYZCopy(hData, ssNewName)

.. us.return

**Return Value**

*hDataNew* is the handle of the new dataset. If the function fails, the return
value is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYZCreate` or :ref:`XYZCreateFromMatrix`.

.. uparam:: ssNewName

   *ssNewName* is the name of the new dataset (optional).

.. us.history

**History**

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

   * - Version
     - Description
   * - 4.2.7
     - New

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZCreate`,
   :ref:`XYZCreateFromMatrix`,
   :ref:`ObjCopy`

:sub:`id-1109481`