Retrieves a signed integer value associated with a specified key from the specified properties object.
am_properties_get_signed_with_default() will return a defined default value if no other value is present, contrary to the behavior of am_properties_get_signed().
#include "am_properties.h" AM_EXPORT am_status_t am_properties_get_signed_with_default(am_properties_t properties, const char *key, long default_value, long *value_ptr);
This function takes the following parameters:
The specified properties object.
Pointer to the specified key in the specified properties object.
Value to return if none is defined for the specified key.
Pointer to the location where the signed integer associated with the specified key will be stored.
This function returns a signed integer value associated with the specified key. If the associated value cannot be parsed as an integer or cannot be represented in the range LONG_MIN to LONG_MAX, AM_INVALID_VALUE will be returned.