page_text()

extern void * KADMOS_API page_text
(const RePageData *repagedata, int page_number,
unsigned char reject_level, int reject_char, char *indent,
int indent_count, long text_format);

Parameter:

repagedata
Pointer auf eine Struktur RePageData.
page_number
Seitnnummer
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:

Mit page_text() erhält man den vollständigen Ergebnistext einer Seite. Mit einem Aufruf von re_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: