.. highlightlang:: us

.. index:: putenv

.. _putenv:

putenv
======

.. us.tag  putenv NOTREADYGERMAN putenv

:ref:`putenv` erzeugt, modifiziert oder entfernt eine Umgebungsvariable.

.. function::  bool = putenv(ssEnvString)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: ssEnvString

   *ssEnvString* ist eine Zeichenkette.

.. us.comment

**Kommentar**

*ssEnvString* ist eine Zeichenkette der Form ``Varablenname=Zeichenkette``,
wobei Variablenname der Name einer Umgebungsvariablen ist, die zugefügt oder
modifiziert werden soll und Zeichenkette ist der Wert. Falls die
Umgebungsvariable bereits existiert, wird der Wert durch Zeichenkette ersetzt,
ansonsten wird die Variable erzeugt. Um eine Variable zu löschen wird als Wert
ein leere Zeichenkette übergeben (``varname=``).

Die Funktion ändert die Umgebung nur für den aktuellen Prozess.

.. us.example

**Beispiel**

::

   ssPath = getenv("path");
   putenv("path=c:\mydir;c:\mydir\mydir2;" + ssPath);

.. seealso::
   :ref:`getenv`

:sub:`id-681352`