.. highlightlang:: us

.. index:: FindFiles

.. _findfiles:

FindFiles
=========

.. us.tag  FindFiles GERMAN FILE_MISC

:ref:`FindFiles` liefert eine String-Matrix mit Dateinamen und weiteren
Informationen.

.. function::  smFiles = FindFiles(ssMatch)

.. us.return

**Returnwert**

*smFiles* ist eine Stringmatrix. Falls keine Dateien gefunden werden, gibt die
Funktion einen leeren String zurück (``""``).

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

   * - Wert
     - Bedeutung
   * - smFiles[;1]
     - Die erste Spalte der Matrix enthält die Dateinamen.
   * - smFiles[;2]
     - Die zweite Spalte der Matrix enthält die Größe der Dateien als String.
   * - smFiles[;3]
     - Die dritte Spalte der Matrix enthält Dateiattribute (siehe :ref:`GetFileAttributes`).

.. us.params

**Parameter**

.. uparam:: ssMatch

   *ssMatch* ist ein Muster das Wildcards wie ``"*"`` oder ``"?"`` enthalten kann
   (z. B. ``"*.xls"``).

.. us.example

**Beispiel**

Die folgende Funktion liefert die Verzeichnisnamen eines Verzeichnisses::

   def GetDirNames(ssDir)
   {
      smInfo = FindFiles(ssDir + "/*");
      rvAttrib = strtod(smInfo[;3]);
      idx = find(rvAttrib & 16);
      if (idx[1] != 0) {
          svDir = smInfo[idx;1];
          // remove "." and ".."
          idx = find(svDir != "." && svDir != "..");
          if (idx[1] != 0) {
             return svDir[idx]';
          }
     }
     return "";
   }

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`GetDirectory`,
   :ref:`GetFileAttributes`

:sub:`id-4577`