Daylight v4.9
Release Date: 1 February 2008


dt_appendstringvalue - Append a string to string value of an object

Generic Prototype

dt_appendstringvalue(dt_Handle, dt_String) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_appendstringvalue(dt_Handle object, dt_Integer strlen, dt_String string)

FORTRAN Prototype

include ''

logical dt_f_appendstringvalue(object, string)

integer*4 object
character*() string


Changes the objects string contents by appending the given string to the object's current stringvalue. The object maintains its own copy of 'string', so the contents of 'string' need not be maintained after calling this function.

Not all objects that return a string (see dt_stringvalue(3)) allow you to set or append that value; only a string object can be appended.

In the Daylight Toolkit, the term "string" refers to an array of 8-bit integers. The Toolkit assigns no special meaning to NULL, space, newline, etc. All string functions operate with explicit lengths.

NOTE: Appending data to the stringvalue of a string object causes the stringvalue of the object to change. Hence the results from prior calls to dt_stringvalue(3) must not be used and must be discarded. It is necessary to call dt_stringvalue(3) again.

Return Value

Returns TRUE if the string value was successfully set, and FALSE if an error was encountered.

Related Topics

dt_alloc_string(3) dt_setstringvalue(3) dt_stringvalue(3)