Daylight v4.9
Release Date: 1 February 2008

Name

dt_proptype - retrieve the type of a named property

Generic Prototype

dt_proptype(dt_Handle, dt_String) => dt_Integer

C Prototype

#include "dt_smiles.h"

dt_Integer dt_proptype(dt_Handle object, dt_Integer nlen, dt_String pname)

FORTRAN Prototype

include 'dt_f_smiles.inc'

integer dt_f_proptype(object, pname)

integer*4 object
character*() pname

Description

Gets the property type of the named property for a given object. Possible values are: DX_PROP_BOOLEAN, DX_PROP_HANDLE, DX_PROP_INTEGER, DX_PROP_REAL, DX_PROP_STRING or DX_PROP_NOPROP.

The value returned will be based upon the last property type set for that property name and object. If a property of the given name has never been set for the object, DX_PROP_NOPROP is returned. Also, if a property is set as a string to the 'invalid string' (dt_setstring(object, pname, 'invalid string')), the property is effectively removed from the object and dt_proptype(3) will return DX_PROP_NOPROP.

Return Value

Returns the property type for the named property or DX_PROP_NOPROP if the named property has not been set for an object or if an error occurs.

Related Topics

dt_boolean(3) dt_handle(3) dt_integer(3) dt_propnames(3) dt_real(3) dt_setboolean(3) dt_sethandle(3) dt_setinteger(3) dt_setreal(3) dt_setstring(3) dt_string(3)