strm_dict_find_rstr()

Updated: April 19, 2023

Get the value of a dictionary entry as a shareable string, based on its key

Synopsis:

#include <sys/strm.h>
const strm_string_t* strm_dict_find_rstr(const strm_dict_t *dict,
                                         const char *key)

Arguments:

dict
A dictionary handle.
key
The key for the entry whose value is being retrieved.

Library:

libstrm

Description:

This function finds the dictionary entry specified by the string in key and returns a handle to the shareable string containing the entry's value.

The returned handle is owned by the dictionary and remains valid until the dictionary handle is destroyed. You can clone the shareable string handle to have one that exists independently of the dictionary.

Returns:

If the entry is found, a handle to the shareable string containing its value. If it's not found, a null pointer.