Allows to retreive the annotated string value stored on the particular node, under the provided key.
- Parameters:
-
| node | The node that is required to return the annotated data. |
| key | The key to be used to lookup for the data annotated. |
| lookup_in_parent | Once the lookup fails, this variable allows to signal the function to also lookup the value in the parent nodes. This mechanism allows to store data on parent nodes that are shared by child nodes. |
NOTE: To make this function work properly you must store double values using
axl_node_annotate_string. Storing values using other functions will lead to unpredictable results.
- Returns:
- The string value stored using axl_node_annotate_string. If the key provided doesn't exists, the function returns NULL.