DBgetTexttabEntry

Determines a text from the text table.

An object, the segment TEXT_SEGMENT, in the data bank is planned for festival texts. These texts are selected, e.g., from a file and then are available to the quick text input. The texts are identified by her number and the zero represents the text grasped last as a special case. DBgetTexttabEntry gets the text with a given number from the table and delivers this as a result. If the text is longer than the handed over buffer, he is cut off when the text does not exist in the table, an empty text is delivered as a result.

Parametre

root (PROOT) [IN]

The trading of the data bank.

text (char *) [IN / OUT]

This pointer must refer to a text buffer with at least maxlen signs. In this the text from the text table is returned.

maxlen (int) [IN]

If the size of the text buffer brags. The size is calculated on final 0-sign.

number (int) [IN]

Gives the index of the desired text in the text table. The values smaller or immediately 0 determine the text buffer. Values from 1 deliver the suitable texts from the text table.

Result

---

Declaration

#include "database.h"

void DLLENTRY DBgetTexttabEntry (

PROOT root,

char * text,

int maxlen,

int number

);