.. highlightlang:: us

.. index:: alias

.. _alias:

alias
=====

.. us.tag  alias GERMAN Programming.Symboltable Changed5700

:ref:`alias` installiert für einen symbolischen Namen einen Ersatztext im
UniScript-Präprozessor bzw. liefert den Ersatztext für einen Namen.

.. function::  bool = alias(ssSymbol, ssValue)
               ssValue = alias(ssSymbol)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich
war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssSymbol

   *ssSymbol* ist ein skalarer String der den Regeln für die Bildung von
   Schlüsselwörtern entspricht. Das heißt, der String muss mit einem Unterstrich
   (``"_"``) oder einem Buchstaben anfangen, gefolgt von beliebig vielen
   Buchstaben, Unterstrichen und Ziffern.

.. uparam:: ssValue

   *ssValue* ist der Ersatztext. Der Ersatztext kann eine beliebige Zeichenkette
   sein. Wenn für den Ersatztext eine leere Zeichenkette angegeben wird, wird der
   Name aus der Präprozessor-Symboltabelle gelöscht.

.. us.example

**Beispiel**

Der folgende Funktionsaufruf installiert für die Zeichen PI die Zeichen 3.141593
in der sogenannten UniScript-Präprozessor Symboltabelle.

::

   alias("PI", "3.141593");
   u = 2 * PI * r;

Nun wird PI aus der Präprozessor-Symboltabelle entfernt::

   alias("PI", "");

Der Ersatztext kann auch andere Zeichen als Ziffern und Buchstaben enthalten.
Durch Definition der folgenden 5 Symbole

::

   alias ("wenn", "if");
   alias ("dann", "{");
   alias ("ende", "}");
   alias ("kleiner", "<");
   alias ("drucke", "print");

kann statt der Anweisung

::

   if (a < b) {
       print "a ist kleiner b"
   }

die Anweisung in dieser Form geschrieben werden::

   wenn (a kleiner b) dann
       drucke "a ist kleiner b"
   ende

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2015
     - Aufruf in der Form ``ssValue = alias(ssSymbol)``.

.. seealso::
   :ref:`uberblick-programmierung`

:sub:`id-293653`