Zum Hauptinhalt springen

C16_TextReadData

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

Text lesen

Details

Mit dieser Funktion wird der Inhalt eines Textes gelesen. Vorher muss die Textinformation mit C16_TextRead() gelesen worden sein. Der Textinhalt kann entweder komplett oder in einzelnen Teilen übertragen werden. Zur kompletten Übertragung muss (aBuffer) ausreichend groß sein. Ist (aBuffer) kleiner als die Gesamtgröße des Textes, so kann C16_TextReadData() mehrfach aufgerufen werden, wobei ab dem zweiten Aufruf die Konstante _TextAppend verwendet werden muss. Durch die Verwendung von _TextBinary können beliebige, in Texten gespeicherte Binärdaten gelesen werden.

In (aTextHdl) wird der mit C16_TextOpen() erzeugte Handle eines Textpuffers übergeben, von dem der Textinhalt gelesen werden soll. In den Parametern (aBuffer) und (aBufferSize) wird ein Zeiger auf einen Puffer, in den der Textinhalt übertragen wird und dessen Größe ü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.
  • _TextSingleLine: Es wird genau eine Zeile übertragen.
  • _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.

In den Parametern (aTextSize) und (aTextLines) werden die Anzahl der gelesenen Zeichen bzw. die Anzahl der gelesenen Zeilen abgelegt. Werden diese Daten nicht benötigt, kann NULL übergeben werden.

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

  • _rOk (0): Der Textinhalt wurde übertragen.
  • C16ERR_TEXT_HDL_INVALID: (aTextHdl) ist ungültig.
  • C16ERR_TEXT_UNDEFINED: Im Textpuffer steht keine gültige Textinformation.