.. highlightlang:: us

.. index:: GetProfileSection

.. _getprofilesection:

GetProfileSection
=================

.. us.tag  GetProfileSection GERMAN uniplot-registry New400

:ref:`GetProfileSection` liefert einen Stringvektor mit allen Schlüssel einer
Sektion in der Form "key=val".

.. function::  svVal = GetProfileSection(ssSection, ssIniFile)

.. us.return

**Returnwert**

*svVal* ist ein a Stringvektor mit allen Schlüsseln der gegebenen Sektion.
Jedes Element besteht aus dem Schlüsselnamen (key) gefolgt von einem
Gleichheitszeichen ("=") gefolgt vom Wert des Schlüssels. Verwenden Sie die
Funktion :ref:`strtok` um ein Element in Schlüsselname und Wert zu zerlegen. Im
Fehlerfall liefert die Funktion einen leeren String ("").

.. us.params

**Parameter**

.. uparam:: ssSection

   *ssSection* ist der Abschnittsname (Sektion).

.. uparam:: ssIniFile

   *ssIniFile* ist der Name der Initialisierungsdatei.

.. us.example

**Beispiel**

Wenn die Datei :file:`test.ini` folgenden Inhalt hat

::

   [Section]
   Key=123
   key2 = "Hallo"

liefert der folgende Aufruf einen Vektor mit den Strings "Key=123" und
"key2=Hallo".

::

   svString = GetProfileSection("Section", "d:/test.ini");
   svString = GetProfileSection("Section", "d:/test.ini");
   if (svString[1] == "") {
       error()
   }

   nKeys = len(svString);
   smKey = strempty(nKeys, 2);
   for (i in 1:nKeys) {
       svKeyVal = strtok(svString[i], "=", FALSE);
       smKey[i;1] = svKeyVal[1];
       smKey[i;2] = svKeyVal[2];
   }

   

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`GetProfileString`,
   :ref:`GetProfileInt`,
   :ref:`GetProfileSectionNames`

:sub:`id-1346108`