Documentation de la bibliothèque MLV-1.2.1

Ce fichier définit les même prototypes des fonctions que MLV_xml.h mais en utilisant en argument sulémentaire une liste de type va_list. Plus de détails...

Aller au code source de ce fichier.

Fonctions
MLV_Xml_error	MLV_get_string_value_from_xml_va (const MLV_Xml *xml_data, char **result, const char *xpath, va_list pile)
	Permet d'accéder à l'interieur d'un champs donné du fichier xml. Plus de détails...
MLV_Xml_error	MLV_get_integer_value_from_xml_va (const MLV_Xml *xml_data, int *result, const char *xpath, va_list pile)
	Permet de récupérer l'entier d'un champs donné du fichier xml. Plus de détails...
MLV_Xml_error	MLV_get_double_value_from_xml_va (const MLV_Xml *xml_data, double *result, const char *xpath, va_list pile)
	Permet de récupérer le reel d'un champs donné du fichier xml. Plus de détails...
MLV_Xml_error	MLV_get_float_value_from_xml_va (const MLV_Xml *xml_data, float *result, const char *xpath, va_list pile)
	Permet de récupérer le réel d'un champs donné du fichier xml. Plus de détails...
int	MLV_get_number_of_objects_from_xml_va (const MLV_Xml *xml_data, const char *xpath, va_list pile)
	Compte le nombre d'objets présents dans le fichier xml verifiant un certain nombre de critères passés en paramètre de la fonction. Plus de détails...
MLV_Xml *	MLV_get_xml_object_of_va (const MLV_Xml *xml_data, const char *xpath, va_list pile)
	Permet de récupérer un noeud interne de l'arbre représentant le fichier XML. Plus de détails...

Description détaillée

Ce fichier définit les même prototypes des fonctions que MLV_xml.h mais en utilisant en argument sulémentaire une liste de type va_list.

Auteur

Adrien Boussicault

Marc Zipstein

Les fichiers xml sont utilisés pour stocker les données nécessaires au fonctionnement d'un programme. Ils permettent de modifier facilement l'exécution du programme sans avoir à le modifier. En effet, ils sont lisibles par l'homme et par la machine en même temps. Ils constituent donc une interface pratique entre l'ordinateur et l'utilisateur.

Documentation des fonctions

MLV_Xml_error MLV_get_double_value_from_xml_va	(	const MLV_Xml *	xml_data,
		double *	result,
		const char *	xpath,
		va_list	pile
	)

Permet de récupérer le reel d'un champs donné du fichier xml.

Tout comme la fonction MLV_get_string_value_from_xml(), cette fonction peut contenir un nombre variable de paramètres. Pour plus d'informations, veuillez lire la documentation de la fonction MLV_get_string_value_from_xml().

Paramètres

xml_data	Les données xml.
result	Un pointeur vers un réel dans lequel le résultat de la fonction sera enregistré.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

renvoie un code d'erreur (voir MLV_Xml_error) si la fonction n'a pas reussie à extraire la donnée souhaitée du document xml.

MLV_Xml_error MLV_get_float_value_from_xml_va	(	const MLV_Xml *	xml_data,
		float *	result,
		const char *	xpath,
		va_list	pile
	)

Permet de récupérer le réel d'un champs donné du fichier xml.

Tout comme la fonction MLV_get_string_value_from_xml(), cette fonction peut contenir un nombre variable de paramètres. Pour plus d'informations, veuillez lire la documentation de la fonction MLV_get_string_value_from_xml().

Paramètres

xml_data	Les données xml.
result	Un pointeur vers un réel dans lequel le résultat de la fonction sera enregistré.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

renvoie un code d'erreur (voir MLV_Xml_error) si la fonction n'a pas reussie à extraire la donnée souhaitée du document xml.

MLV_Xml_error MLV_get_integer_value_from_xml_va	(	const MLV_Xml *	xml_data,
		int *	result,
		const char *	xpath,
		va_list	pile
	)

Permet de récupérer l'entier d'un champs donné du fichier xml.

Tout comme la fonction MLV_get_string_value_from_xml(), cette fonction peut contenir un nombre variable de paramètres. Pour plus d'informations, veuillez lire la documentation de la fonction MLV_get_string_value_from_xml().

Paramètres

xml_data	Les données xml.
result	Un pointeur vers un entier dans lequel le résultat de la fonction sera enregistré.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

renvoie un code d'erreur si la fonction n'a pa reussie à extraire la donnée souhaitée du document xml.

int MLV_get_number_of_objects_from_xml_va	(	const MLV_Xml *	xml_data,
		const char *	xpath,
		va_list	pile
	)

Compte le nombre d'objets présents dans le fichier xml verifiant un certain nombre de critères passés en paramètre de la fonction.

Paramètres

xml_data	Les données xml.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

Cette fonction renvoie le nombre d'objet ayant pour chemin d'accès "xpath".

MLV_Xml_error MLV_get_string_value_from_xml_va	(	const MLV_Xml *	xml_data,
		char **	result,
		const char *	xpath,
		va_list	pile
	)

Permet d'accéder à l'interieur d'un champs donné du fichier xml.

Attention: Il ne faut pas oublier de libérer la mémoire associée au champs result.

Paramètres

xml_data	Les données xml.
result	Un pointeur vers une addresse vide qui contiendra l'addresse de la chaîne de caractères correspondant au résultat de la fonction.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

renvoie un code d'erreur si la fonction n'a pa reussie à extraire la donnée souhaitée du document xml.

MLV_Xml* MLV_get_xml_object_of_va	(	const MLV_Xml *	xml_data,
		const char *	xpath,
		va_list	pile
	)

Permet de récupérer un noeud interne de l'arbre représentant le fichier XML.

Cette fonction n'est pas encore implémentée.

Paramètres

xml_data	Les données xml.
xpath	Le chemin d'accès.
pile	La pile des complements de paramètres comme dans vaprintf.

Renvoie

Un noeud interne de l'arbre XML.