rep_text()

extern void * KADMOS_API rep_text
  (const RepData *repdata, long output_code, unsigned char reject_level,
  int reject_char, char *indent, int indent_count, long text_format);

Parameter:

repdata
Pointer auf eine Struktur RepData.
output_code
Die Codepage, in der der Text dargestellt wird.
reject_level
Vertrauenswert, bis zu dem die Ausgabe eines Resultatzeichens erfolgen soll.
reject_char
Zeichen, das bei einer Rückweisung eingesetzt werden soll.
indent
Führende Zeichen wie z.B. Leehrzeichen.
indent_count
Anzahl von ident.
text_format
Ausgabeformat der Textzeile als TEXT_FORMAT_ANSI oder TEXT_FORMAT_KADMOS_MULTIBYTE. TEXT_FORMAT_RELRESULT_INDICES liefert unter 'buffer' die Ausgabe-Reihenfolge der einzelnen erkannten Zeichen. Die Ergebnis-Graphen von rel_do() oder rep_do() sind immer so geordnet, dass die erkannten Zeichen von links nach recht angeordnet sind. Bei Zeichen mit Akzenten werden die Komponenten von oben nach unten ausgegeben. In Thai aber (z.B.) muss bei Texten immer erst das Hauptzeichen geschrieben werden, dann die oberen Akzente von unten nach oben, dann der untere Akzent. Die Funktionen re*_textline() machen das auch automatisch so. Nur brauchen manche Integratoren explizit etwa die Positionen der Zeichen und Akzente, müssen also auf die zugehörigen RelResult-Strukturen zugreifen. Das ermöglicht der Aufruf von re*_textline() mit dem Parameter TEXT_FORMAT_RELRESULT_INDICES.

Rückgabewert:

RE_SUCCESS oder KADMOS-Fehlertyp.

Bemerkung:

rep_text() liefert den vollständigen Ergebnistext eines Absatzes. rep.init.rep_memory muss davor allokiert werden. Mit einem Aufruf von free(return_value) kann der allokierte Speicher wieder freigegeben werden.

Im Erfolgsfall gibt die Funktion RE_SUCCESS zurück, im Fehlerfall einen entsprechenden Fehlertyp. Klartext-Information über aufgetretene Fehler kann mit re_GetErrorText() abgeholt oder mit re_DisplayErrorText() angezeigt werden.

Verweise: