FsiOpen

FsiOpen(alpha1, int2) : handle

Datei öffnen

Details

• alpha1: Dateiname/-pfad
• int2: Optionen (siehe Text)
• Resultat: handle Datei-Deskriptor oder Fehlerwert
• Siehe: Verwandte Befehle , FsiClose () , Fehlerwerte , Beispiel

Mit dieser Funktion wird die externe Datei (alpha1) geöffnet. In (alpha1) kann der vollständige Pfad angegeben werden. In (int2) muss mindestens eine der _FsiAcs...-Optionen angegeben werden, da ansonsten keine Operationen auf der Datei durchgeführt werden können.

Außerdem sollte unbedingt eine der _FsiDeny...-Optionen benutzt werden, um die Multiuser-Fähigkeit sicherzustellen.

Folgende Optionen können in (int2) angegeben werden:

• _FsiAcsR Nur Lesezugriff
• _FsiAcsW Nur Schreibzugriff
• _FsiAcsRW Lese- und Schreibzugriff
• _FsiDenyR Exklusiver Lesezugriff
• _FsiDenyW Exklusiver Schreibzugriff
• _FsiDenyRW Exklusiver Lese- und Schreibzugriff
• _FsiDenyNone Kein exklusiver Zugriff
• _FsiCreate Datei anlegen oder öffnen
• _FsiCreateNew Datei explizit anlegen
• _FsiTruncate Datei leeren
• _FsiAppend Datei erweitern
• _FsiSyncWrite Synchrones Schreiben
• _FsiStdRead Standard-Lesemodus
• _FsiStdWrite Standard-Schreibmodus
• _FsiBuffer Lesen/Schreiben puffern
• _FsiNoCache Lesen/Schreiben nicht puffern
• _FsiANSI Lesen/Schreiben einer ANSI-Datei
• _FsiPure Keine Zeichenwandlung beim Lesen oder Schreiben einer Datei
• _FsiNameC16 Dateiname ist im CONZEPT 16-Zeichensatz angegeben
• _FsiNameUtf8 Dateiname ist im UTF-8-Zeichensatz angegeben

Die folgenden Optionen (int2) gelten nur für Windows:

• _FsiDeleteOnClose Datei temporär öffnen

Die folgenden Optionen (int2) gelten nur für UNIX:

• _FsiUserR Leseberechtigung für Benutzer
• _FsiUserW Schreibberechtigung für Benutzer
• _FsiGroupR Leseberechtigung für Gruppe
• _FsiGroupW Schreibberechtigung für Gruppe
• _FsiOtherR Leseberechtigung für Andere
• _FsiOtherW Schreibberechtigung für Andere

Das Resultat ist größer Null, wenn die Datei erfolgreich geöffnet wurde. Bei einem negativen Resultat ist ein Fehler aufgetreten. Der Fehlerwert des Betriebssystems kann über die Eigenschaft FsiError abgefragt werden. Wurde die Option _FsiCreateNew angegeben und die Datei existiert bereits, ist das Resultat _ErrFsiExists.

Beispiele:

tHandle # FsiOpen('\Test.asc', _FsiStdRead);
if (tHandle > 0)
{
  ...
  tHandle->FsiClose();
}
else
{
  // Fehlerbehandlung
  ...
}

// Liste aller Dateien eines Verzeichnisses erstellen
sub WriteFileList
(
  aPath : alpha(4096);
)

    local
    {
      tHdlDir   : handle;
      tName     : alpha(4096);
      tFile     : handle;
      tTestFile : handle;
    }

{
  tHdlDir # FsiDirOpen(aPath + '\*.txt', _FsiNameUtf8);
  tFile # FsiOpen(aPath + '\files.txt', _FsiStdWrite | _FsiPure);

  tName # tHdlDir->FsiDirRead();

  while (tName != '')
  {
    tTestFile # FsiOpen(aPath + '\' + tName, _FsiStdRead | _FsiNameUtf8);

    if (tTestFile > 0)
    {
      tName # tName + ' -> Open OK';
      tTestFile->FsiClose();
    }
    else
      tName # tName + ' -> Open FAIL';

    tFile->FsiWrite(tName);
    tFile->FsiWrite(StrChar(13) + StrChar(10));      

    tName # tHdlDir->FsiDirRead();
  }

  tHdlDir->FsiDirClose();
  tFile->FsiClose();
}