pips_guid_from

Encode a GUID based on its string representation

Synopsis:

#include <pips/pips.h>

int pips_guid_from_str(pips_guid_t *guid,
                       const char *str,
                       const int str_len)

Arguments:

guid: A pointer to a buffer for storing the encoded GUID
str: The input string to convert into a GUID
str_len: The maximum length of the input string

Library:

pips-client

Description:

This function parses the given string representation of a GUID and encodes it as a 128-bit value. The string can be up to 32 characters long (the space required for a hexadecimal representation of a 128-bit value). If the string is shorter, the GUID's most significant bits are padded with zeros.

Returns:

0: The string was successfully parsed and converted into a GUID

-1: An error prevented the string from being converted into a GUID (errno is set)

Errors:

EINVAL: The input string reference is invalid.
ENOTTY: The GUID storage buffer reference is invalid.
EPROTO: The input string does not contain a valid GUID.