Sous-routine uuid_to_string ou uuid_from_string
Objectif
Convertir entre des identificateurs uniques et binaires (UUIDs).
Libaire
Bibliothèque C standard (libc.a)
Syntaxe
#include <uuid.h>void uuid_from_string(uuid_string,uuid, status)
uuid_p_t uuid;
unsigned_char_p_t *uuid_string;
unsigned32 *status;
Descriptif
La sous-routine Uuid_to_chaîne convertit un UUID binaire en UUID de chaîne. Le paramètre uuid_string doit pointer vers une zone de mémoire avec suffisamment d'espace pour stocker l'UUID de chaîne, sinon les résultats ne sont pas définis. Si une valeur NULL est transmise comme second argument du paramètre uuid_to_string, la mémoire requise est automatiquement allouée en appelant la sous-routine Malloc . La sous-routine Uuid_from_chaîne convertit un UUID de chaîne en UUID binaire. La longueur de la chaîne transmise au paramètre uuid_from_string doit être égale à 0 ou la longueur de UUID_C_UUID_STRING_MAX. Lors de l'exécution réussie, uuid_s_ok est stocké dans l'emplacement désigné par le paramètre d'état.
Paramètres
| Article | Descriptif |
|---|---|
| uuid | Pointe vers l'emplacement contenant l'UUID binaire |
| Chaîd_uuid_uuu | Pointe vers l'emplacement contenant l'UUID de chaîne |
| status | Pointe vers l'emplacement où le statut de l'opération est stocké |
Valeurs renvoyées
Il n'existe aucune valeur de retour, cependant, si la chaîne transmise à la sous-routine Uuid_from_chaîne n'est pas valide, l'emplacement désigné par le paramètre d'état est défini sur uuid_s_invalid_string_uuid. Si une valeur NULL est transmise au sous-programme Uuid_to_chaîne en tant que second paramètre et que le système est à court de mémoire, l'emplacement désigné par le paramètre de statut est défini sur uuid_s_no_memory.