# Documentation de la bibliothèque MLV-1.2.1

- Presentation
- Téléchargement
- Installation
- Compilation
- Exemples
- API
- Liste des fonctions
- bogues
- FAQ
- contacts

Fonctions
Référence du fichier MLV_xml_va.h

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.