.. highlightlang:: us

.. index:: bit_set

.. _bit_set:

bit_set
=======

.. us.tag bit_set NOTREADYGERMAN bit-ops New5510

:ref:`bit_set` setzt ein Bit oder schaltet es aus.

.. function:: m = bit_set(m, nBit)
              m = bit_set(m, nBit, cast)
              m = bit_set(m, nBit, bool, cast)

.. us.return

**Returnwert**

*m* ist eine Matrix mit Integern.

.. us.params

**Parameter**

.. uparam:: m

   *m* ist eine Matrix.

.. uparam:: nBit

   *nBit* ist die 0-basierte Bitnummer. Bei 32-Bit-Integern können alle Bits
   verwendet werden (0..31), bei 64-Bit-Integern nur die Bits 0 bis 52.

.. uparam:: cast

   *cast* ist einer der folgenden Werte:

   .. list-table::
      :header-rows: 0

      * - CAST_INT8 (0)
        -
      * - CAST_UINT8 (1)
        -
      * - CAST_INT16 (2)
        -
      * - CAST_UINT16 (3)
        -
      * - CAST_INT32 (4)
        -
      * - CAST_UINT32 (5)
        -
      * - CAST_INT64 (6)
        -
      * - CAST_UINT64 (7)
        - default-Wert.

.. us.comment

**Kommentar**

UniScript verwendet doppelt genaue Gleitkommazahlen. Beim casten mit
``CAST_INT64`` und ``CAST_UINT64`` können deshalb nur die untersten 53 Bits
(Bit 0 .. Bit 52) verwendet werden.

.. us.example

**Beispiel**

::

   m = 0;
   m = bit_set(m, 40)

   m = bit_set(m, 31, CAST_UINT32)

   // bit 31 wieder löschen
   m = bit_set(m, 31, 0, CAST_UINT32)

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.10
     - Neu.

.. seealso::
   :ref:`bit-ops`,
   :ref:`bit_get`,
   :ref:`bit_and`,
   :ref:`bit_or`,
   :ref:`bit_xor`,
   :ref:`bit_not`,
   :ref:`bit_lshift`,
   :ref:`bit_rshift`

:sub:`id-1110941`