CHFL_PROPERTY

typedef struct CHFL_PROPERTY CHFL_PROPERTY

This class holds the data used in properties in CHFL_FRAME and CHFL_ATOM. A property can have various types: bool, double, string or chfl_vector3d.

Here is the full list of functions acting on CHFL_PROPERTY:

• chfl_property_bool()

• chfl_property_double()

• chfl_property_string()

• chfl_property_vector3d()

• chfl_property_get_kind()

• chfl_property_get_bool()

• chfl_property_get_double()

• chfl_property_get_string()

• chfl_property_get_vector3d()

---

CHFL_PROPERTY *chfl_property_bool(bool value)

Create a new property holding a boolean value.

The caller of this function should free the allocated memory using chfl_free.

Returns:

A pointer to the property, or NULL in case of error. You can use chfl_last_error to learn about the error.

CHFL_PROPERTY *chfl_property_double(double value)

Create a new property holding a double value.

The caller of this function should free the allocated memory using chfl_free.

Returns:

A pointer to the property, or NULL in case of error. You can use chfl_last_error to learn about the error.

CHFL_PROPERTY *chfl_property_string(const char *value)

Create a new property holding a string value.

The caller of this function should free the allocated memory using chfl_free.

Returns:

A pointer to the property, or NULL in case of error. You can use chfl_last_error to learn about the error.

CHFL_PROPERTY *chfl_property_vector3d(const chfl_vector3d value)

Create a new property holding a 3D vector value.

The caller of this function should free the allocated memory using chfl_free.

Returns:

A pointer to the property, or NULL in case of error. You can use chfl_last_error to learn about the error.

chfl_status chfl_property_get_kind(const CHFL_PROPERTY *property, chfl_property_kind *kind)

Get the type of value held by this property in kind.

Returns:

The operation status code. You can use chfl_last_error to learn about the error if the status code is not CHFL_SUCCESS.

chfl_status chfl_property_get_bool(const CHFL_PROPERTY *property, bool *value)

Get the boolean value held by this property in the location pointed to by value.

This function returns CHFL_PROPERTY_ERROR if the property is not a boolean property.

Returns:

The operation status code. You can use chfl_last_error to learn about the error if the status code is not CHFL_SUCCESS.

chfl_status chfl_property_get_double(const CHFL_PROPERTY *property, double *value)

Get the double value holded by this property in the location pointed to by value.

This function returns CHFL_PROPERTY_ERROR if the property is not a double property.

Returns:

The operation status code. You can use chfl_last_error to learn about the error if the status code is not CHFL_SUCCESS.

chfl_status chfl_property_get_string(const CHFL_PROPERTY *property, char *buffer, uint64_t buffsize)

Get the string value held by this property in the given buffer.

This function returns CHFL_PROPERTY_ERROR if the property is not a string property.

The buffer size must be passed in buffsize. This function will truncate the property to fit in the buffer.

Returns:

The operation status code. You can use chfl_last_error to learn about the error if the status code is not CHFL_SUCCESS.

chfl_status chfl_property_get_vector3d(const CHFL_PROPERTY *property, chfl_vector3d value)

Get the 3D vector value held by this property in the location pointed to by value.

This function returns CHFL_PROPERTY_ERROR if the property is not a 3D vector property.

Returns:

The operation status code. You can use chfl_last_error to learn about the error if the status code is not CHFL_SUCCESS.