diub-Dokumentation

Inhalt

Titel


9 diub.IO

Oft benötigte Stream-Varianten und Funktionen für den Umgang mit langen(!) Pfaden.

9.1 LockFile

Zum einfachen Anlegen und Löschen von Sperr-Dateien im Verzeichnis der angegebenen Datei.

LockFile lf; CommonStatus cs; // Sperr-Datei anlegen: Rückgabe NULL, falls nicht erfolgreich lf = LockLocal ("PathFilename"); // Sperr-Datei löschen: Rückgabe CommonStatus.Ok/Failed cs = lf.UnlockLocal (); cs = LockFile.UnlockLocal (lf); cs = LockFile.UnlockLocal (LockFile "PathFilename");

9.2 SpecialPathes

Die Funktionen liefern wohl-definierte Namen, Pfade und Dateinamen zurück.

Achtung: die Pfade oder Dateien müssen zu diesem Zeitpunkt nicht existieren !

Name & Pfad der ausgeführten Datei

stirng = s; // enspricht ProductName s = SpecialPathes.AppName; // Pfad zur gestarteten Exe inkl. Dateiname s = SpecialPathes.ExePath; // Pfad zur gestarteten Exe ohne Dateiname s = SpecialPathes.ExeBasePath; // Name der ausgeführten Datei nach eingetragenen Assmbly-Informationen // ohne Dateiendung s = SpecialPathes.ExeNameAI; // Name der ausgeführten Datei nach eingetragenen Assmbly-Informationen // inklusive Dateiendung s = SpecialPathes.ExeFilenameAI; // Name der ausgeführten Datei nach laufendem Prozess; inklusive Dateiendung // inklusive Dateiendung s = SpecialPathes.ExeFilenameCurrentProcess; // Name der ausgeführten Datei nach Parameter 0 der Kommandozeile beim Aufruf // inklusive Dateiendung s = SpecialPathes.ExeNameCMD; // Name der ausgeführten Datei nach Parameter 0 der Kommandozeile beim Aufruf // inklusive Dateiendung s = SpecialPathes.ExePathFilenameCMD; // Pfad & Name der ausgeführten Datei nach eingetragenen Assmbly-Informationen // ohne Dateiendung s = SpecialPathes.ExePathNameAI; // Pfad & Name der ausgeführten Datei nach eingetragenen Assmbly-Informationen // inklusive Dateiendung. s = SpecialPathes.ExePathFilenameAI;

Erweiterte Profil-Pfade

string s; // Pfad nach AppData im Benutzerprofil! s = SpecialPathes.UserProfileAppDataPath; // Pfad nach %Users%/%Username%/AppData/Local/diub/%AppName%/ im Benutzerprofil! s= SpecialPathes.UserProfileAppDataAppNamePath; // Pfad nach %Users%/%Username%/AppData/Local/diub/%AppName%/%ExampleSubDir% // Der Pfad wird bei Bedarf angelegt. s = SpecialPathes.UserProfileAppDataDirNamePath ("ExampleSubDir");

Erweiterte Benutzer Pfade

string s; // Pfad nach: %Users%/%Username%/Documents/diub/ s = SpecialPathes.DocumentsDiubPath; // Pfad nach: %Users%/%Username%/Documents/diub/%AppName%/ s = SpecialPathes.DocumentsDiubAppNamePath;

Erweitere gemeinsame Pfade

string s; // Pfad zu %CommonApplicationData%/diub // Der Pfad wird bei Bedarf angelegt. s = SpecialPathes.CommonDataDiubPath; // Pfad zu %CommonApplicationData%/diub/%AppName% // Der Pfad wird bei Bedarf angelegt. s = SpecialPathes.CommonDataDiubPath;

Temporäre Dateien

string s; // Extension ohne Punkt! s = SpecialPathes.GetTmpPathFilename (string Extension); // Extension ist "tmp" s = SpecialPathes.TmpPathFilename;

Temporäre Pfade

string s; // vom System gieferter Pfad für temporäre Dateien s = SpecialPathes.TmpPath; // liefert %TmpPath%/%AppName% s = SpecialPathes.TmpExeNamedPath;

9.3 Streams

ChunksStream

Stellt einen einzelnen (Datei-)Stream bereit, der automatisch auf multiple Dateien (Chunks) definierter Größe verteilt wird.

  • Standardwert für einen Chunk ist 1 GB.
  • Der angegebene Dateiname wird generisch verwendet in der Form 'Dateiname.000.Ext' für die erste Datei mit fortlaufender Numerierung.
  • Wird keine Extension angegeben, ist der Default-Wert dafür 'chunk'.

Wichtiger Hinweis

Ein Aufruf von SetLength löscht nicht mehr benötigte Chunks!