DBreturnTextString

The text of a text element determine.

To the trading of a text element his text contents are determined. The contents are copied, a change in the returned text string does not affect the contents of the data bank. Because the length of the text is not limited, the maximum length of the text (including 0-sign as an end) will hand over about the parametre len by the call of DBreturnTextString to the procedure. With return from the procedure the field contains the real length of the text, if this is shorter than the maximum value or the maximum value if he is longer. In this case the returned text is shortened. It is initialized len with 0, it is written instead of this in len the length of the text and the text is not returned.

Parametre

element (PTEXT_ELEMENT) [IN]

The trading of the text by which the text contents should be determined. Here even one may be handed over text-trades, all other does not like the system. An examination takes place if the Debugversion is used.

len (int *) [IN / OUT]

If by call here the value 0 stands, is put down only in len the real length of the string. A value incomparably 0 describes the maximum length of the text with the return. If the text is longer than this value, he is cut off. The length is meant in each case including the final 0.

textString (char *) [IN / OUT]

This is a pointer on an area of at least len signs. In this area the text contents are copied. If by call in len 0 stand, this pointer is not used, can own every value.

Result

(T_ERROR) [OUT]

If the procedure could be explained perfectly, it delivers ERROR_OK, but one of the error messages from error.h.

Declaration

#include "database.h"

T_ERROR DLLENTRY DBreturnTextString (

PTEXT_ELEMENT element,

int * len,

char * textString

);

Related procedures

DBreturnExpandedText