FCreate(): Unterschied zwischen den Versionen
Georg (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Georg (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
| Zeile 2: | Zeile 2: | ||
== Allgemeines == | == Allgemeines == | ||
Die Funktion fCreate() dient dazu, eine Datei neu zu erstellen. | 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. | ||
| Zeile 23: | Zeile 23: | ||
! Erläuterung | ! Erläuterung | ||
|- | |- | ||
| FC_NORMAL | normal | es sind keine besonderen Attribute erforderlich | | FC_NORMAL || normal || es sind keine besonderen Attribute erforderlich | ||
|- | |- | ||
| FC_READONLY | Read-Only | die Datei kann nur lesend geöffnet werden | | FC_READONLY || Read-Only || die Datei kann nur lesend geöffnet werden | ||
|- | |- | ||
| FC_HIDDEN | Hidden | die Datei wird normalerweise nicht angezeigt | | FC_HIDDEN || Hidden || die Datei wird normalerweise nicht angezeigt | ||
|- | |- | ||
| FC_SYSTEM | System | die Datei wird als System-Datei gekennzeichnet | | FC_SYSTEM || System || die Datei wird als System-Datei gekennzeichnet | ||
|} | |} | ||
| Zeile 35: | Zeile 35: | ||
== Rückgabewert == | == 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. | |||
Aktuelle Version vom 10. Januar 2017, 14:26 Uhr
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