dt_appendstring

Daylight v4.9
Release Date: 1 February 2008

Name

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 'dt_f_smiles.inc'

logical dt_f_appendstring(object, pname, value)

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

Description

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