Daylight v4.9
Release Date: 1 February 2008

Name

dt_setboolean - specify the boolean value of a named property

Generic Prototype

dt_setboolean(dt_Handle, dt_String, dt_Integer) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_setboolean(dt_Handle object, dt_Integer nlen, dt_String pname, dt_Boolean value)

FORTRAN Prototype

include 'dt_f_smiles.inc'

logical dt_f_setboolean(object, pname, value)

integer*4 object
character*() pname
logical value

Description

Causes the named property 'pname' to be created or modified, as appropriate. Sets the value of the named property 'pname' to 'value'. Also sets the property type of the named property to be set to DX_PROP_BOOLEAN (returned by dt_proptype(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. The 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_boolean(3) dt_proptype(3) dt_setstringvalue(3)