Zum Hauptinhalt springen

C16_TextWriteData

C16_TextWriteData(const vPHANDLE aTextHdl, const void* aBuffer, const vFLAGS aFlags, const vINT aTextSize) : vERROR​

Text speichern

Details

Mit dieser Funktion kann der Inhalt eines Textes geschrieben werden. Der Text muss vorher mit C16_TextRead() gelesen und gesperrt worden sein. Alternativ kann ein neuer Text mit C16_TextCreate() angelegt und gesperrt werden. Der Text kann entweder komplett oder in mehreren Teilen übertragen werden. Bei der Übertragung mehrerer Teile muss bei allen Aufrufen von C16_TextWriteData() die Konstante _TextAppend verwendet werden, ausgenommen beim letzten Aufruf. In (aTextHdl) wird der mit C16_TextOpen() erzeugte Handle eines Textpuffers übergeben, von dem der Textinhalt geschrieben werden soll. In den Parametern (aBuffer) und (aTextSize) wird der Zeiger auf einen Puffer, in dem sich die zu schreibenden Daten befinden und die Anzahl der Bytes in diesem Puffer übergeben. Um die Übertragung zu steuern, stehen für den Parameter (aFlags) folgende symbolischen Konstanten zur Verfügung:

  • _TextAppend: Es werden die Daten ab dem Ende der letzten Übertragung gelesen.
  • _TextBinary: Die Daten werden binär (1:1) übertragen.
  • _TextEolNull: Die Zeilen werden mit NUL (ASCII 0) beendet.
  • _TextEolCR: Die Zeilen werden mit CR (ASCII 13) beendet.
  • _TextEolLF: Die Zeilen werden mit LF (ASCII 10) beendet.
  • _TextEolCRLF: Die Zeilen werden mit CR+LF (ASCII 13+10) beendet.
  • _Text_CharSet_C16: Es findet keine Zeichensatzwandlung statt.
  • _Text_CharSet_OEM: Der Text wird in den OEM-Zeichensatz umgewandelt.
  • _Text_CharSet_ANSI: Der Text wird in den ANSI-Zeichensatz umgewandelt.

Folgende Fehlerwerte vom Typ vERROR können zurückgegeben werden:

  • _rOk (0): Der Textinhalt wurde geschrieben.
  • _rNoLock (7): Der Text ist nicht gesperrt.
  • C16ERR_TEXT_HDL_INVALID: (aTextHdl) ist ungültig.
  • C16ERR_TEXT_RIGHTS: Schreibberechtigung nicht ausreichend.