FCreate()
Allgemeines
Die Funktion fCreate() dient dazu, eine Datei neu zu erstellen. Nach erfolgreichem Erstellen wird die Datei automatisch geöffnet und steht zur Verarbeitung zur Verfügung.
Syntax
fCreate(<cFileName>, [<nAttributes>]) => nFileHandle
Parameter
<cFileName> gibt an, wie die zu erstellende Datei heissen soll. Wenn die Datei nicht im aktuellen Verzeichnis erstellt werden soll, müssen gegebenenfalls Laufwerk und Verzeichnis mit angegeben werden.
<nAttributes> ist ein optionaler Parameter, der bestimmt, oder der Datei besondere Attribute zugeordnet werden sollen. Figurative Konstanten sind in der Datei FileIO.ch definiert:
| Konstante | Attribut | Erläuterung |
|---|---|---|
| FC_NORMAL | normal | es sind keine besonderen Attribute erforderlich |
| FC_READONLY | Read-Only | die Datei kann nur lesend geöffnet werden |
| FC_HIDDEN | Hidden | die Datei wird normalerweise nicht angezeigt |
| FC_SYSTEM | System | die Datei wird als System-Datei gekennzeichnet |
Rückgabewert
<nFileHandle> ist ein numerischer Wert, über den auf die Datei zugegriffen werden kann. Wenn nFileHandle einen Wert kleiner Null hat, ist die Erstellung (oder das Öffnen) fehlgeschlagen. Die Fehlerursache kann mittels der Funktion fError() ermittelt werden.
Besonderheiten
Während die anderen Low Level Dateifunktionen wie fAttr() die Dateiattribute mit Zeichenvariablen definieren, verwendet fCreate() numerische Werte.
Querverweis
benötigte DLLs bzw. Include-Dateien
XppRt1.lib
FileIO.ch