Daylight v4.9
Release Date: 1 February 2008


dt_appendstring - append data to the string value of a named property

Generic Prototype

dt_appendstring(dt_Handle, dt_String, dt_String) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_appendstring(dt_Handle object, dt_Integer nlen, dt_String pname, dt_Integer vlen, dt_String value)

FORTRAN Prototype

include ''

logical dt_f_appendstring(object, pname, value)

integer*4 object
character*() pname
character*() value


Causes the named property to be modified. Appends the given string to the current value of the named property 'pname'. The named property must be of type DX_PROP_STRING or this function will fail. If the named property does not exist the function sets the string property to the given string, eg. it works like dt_setstring(3).

Named properties can be set for any object in the toolkit. The properties are owned by the object, and become invalid if the object is deallocated. A property name may be any valid string (see dt_setstringvalue(3)).

Return Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_proptype(3) dt_setstring(3) dt_string(3)