.. index:: 
  !FaceCandidateList Class

.. _id3_face_face_candidate_list_class:

===============================================================================
FaceCandidateList Class
===============================================================================

Namespace: :ref:`id3.Face<reference_face>`

.. toctree::
  :hidden:

  add<add>
  clear<clear>
  clone<clone>
  count<count>
  get<get>
  getCount<get_count>
  removeAt<remove_at>
  resize<resize>
  set<set>


Definition
----------
.. line-block::
    Represents a candidate list in a one-to-many search.

.. tab-set::

    .. tab-item:: Python
      :sync: Python

      .. code:: Python

        class FaceCandidateList

    .. tab-item:: Dart
      :sync: Dart

      .. code:: Dart

        class FaceCandidateList implements Finalizable

    .. tab-item:: C#
      :sync: C#

      .. code:: C#

        public partial class FaceCandidateList

    .. tab-item:: Java
      :sync: Java

      .. code:: Java

        public class FaceCandidateList implements AutoCloseable, Serializable

    .. tab-item:: Swift
      :sync: Swift

      .. code:: Swift

        public class FaceCandidateList

    .. tab-item:: C
      :sync: C

      .. code:: C

        typedef struct id3FaceCandidateList *ID3_FACE_CANDIDATE_LIST;



Usage
-----

.. tab-set::

    .. tab-item:: Python
      :sync: Python

      .. code:: Python

        faceCandidateListInstance = id3face.FaceCandidateList()

      **Explicit destruction**

      .. code:: Python

        # ...
        del faceCandidateListInstance

    .. tab-item:: Dart
      :sync: Dart

      .. code:: Dart

        final faceCandidateListInstance = sdk.FaceCandidateList();
        // ...

      **Explicit destruction**

      .. code:: Dart

        // ...
        faceCandidateListInstance.dispose()

    .. tab-item:: C#
      :sync: C#

      .. code:: C#

        using (var faceCandidateListInstance = new FaceCandidateList())
        {
           // ...
        }

      **Explicit destruction**

      .. code:: C#

        var faceCandidateListInstance = new FaceCandidateList()
        // ...
        faceCandidateListInstance.Dispose()

    .. tab-item:: Java
      :sync: Java

      .. code:: Java

        try (FaceCandidateList faceCandidateListInstance = new FaceCandidateList()) {
        // ...
        }

      **Explicit destruction**

      .. code:: Java

        FaceCandidateList faceCandidateListInstance = new FaceCandidateList();
        // ...
        faceCandidateListInstance.close();

    .. tab-item:: Swift
      :sync: Swift

      .. code:: Swift

        private var faceCandidateListInstance: FaceCandidateList? = nil
        faceCandidateListInstance = try FaceCandidateList()

    .. tab-item:: C
      :sync: C

      .. code:: C

        ID3_FACE_CANDIDATE_LIST hFaceCandidateList{};
        int err = id3FaceCandidateList_Initialize(&hFaceCandidateList);
        if (err == ID3_SUCCESS) {
            // ...
            id3FaceCandidateList_Dispose(&hFaceCandidateList);
        }


Properties
----------

.. list-table:: 
  :width: 100%
  :widths: 30 5 65
  :header-rows: 1

  * - Name
    - Type
    - Description
  * - :ref:`count<id3_face_face_candidate_list_count_class_member>`
    - int
    - Gets the number of elements contained in the list
  * - operator [int index]
    - :ref:`FaceCandidate<id3_face_face_candidate_class>`
    - Gets or sets the element at the specified index in the list.

Iteration
---------

This class supports iteration in Dart, C#, Java and Python.


Methods
-------

.. list-table:: 
  :width: 100%
  :widths: 30 70
  :header-rows: 1

  * - Name
    - Description
  * - :ref:`add<id3_face_face_candidate_list_add_class_method>`
    - Adds an item to the FaceCandidateList object.
  * - :ref:`clear<id3_face_face_candidate_list_clear_class_method>`
    - Clears the FaceCandidateList object.
  * - :ref:`clone<id3_face_face_candidate_list_clone_class_method>`
    - Clones the FaceCandidateList object.
  * - :ref:`get<id3_face_face_candidate_list_get_class_method>`
    - Gets an item of the FaceCandidateList object.
  * - :ref:`getCount<id3_face_face_candidate_list_get_count_class_method>`
    - Gets the number of elements in the FaceCandidateList object.
  * - :ref:`removeAt<id3_face_face_candidate_list_remove_at_class_method>`
    - Removes an element of the FaceCandidateList object.
  * - :ref:`resize<id3_face_face_candidate_list_resize_class_method>`
    - FaceCandidateList object.
  * - :ref:`set<id3_face_face_candidate_list_set_class_method>`
    - Sets an item of the FaceCandidateList object.
