Documentation de la bibliothèque MLV-0.5

Fonctions

Référence du fichier MLV_path.h

Ce fichier définit les prototypes des fonctions permettant de manipuler les chemin d'acces aux fichiers et répertoires. Plus de détails...

Aller au code source de ce fichier.

Fonctions

char * MLV_get_base_name (const char *path)
 Renvoie la chaîne de caractères après le dernier séparteur / dans un chemin donné en paramètre.
char * MLV_get_directory_name (const char *path)
 Renvoie la chaîne de caractère s'étendnant jusqu'au dernier séparateur / du chemin donné en paramètre.
int MLV_path_is_absolute (const char *path)
 Teste si un chemin est absolu.
int MLV_path_is_relative (const char *path)
 Teste si un chemin est relatif.
int MLV_path_exists (const char *path)
 Teste si le chemin corespond au chemin d'un fichier ou dossier existant.
int MLV_path_is_a_directory (const char *path)
 Vérifie si un chemin est un associé à un répertoire.
int MLV_path_is_a_file (const char *path)
 Vérifie si un chemin est un associé à un fichier.
char * MLV_build_path (const char *first_element,...)
 Construit en concaténant différents textes, une chaine de caractère représentant un chemin dont les séparateurs corespondent aux spécifications de la plateforme sur laquel s'execute le programme.
char * MLV_build_path_v (char **elements)
 Même chose que MLV_build_path.
const char * MLV_get_current_directory ()
 Determine le répertoire courant.
const char * MLV_get_temporary_directory ()
 Determine le répertoire temporaire.
const char * MLV_get_home_directory ()
 Determine le répertoire personnel de l'utilisateur courant.

Description détaillée

Ce fichier définit les prototypes des fonctions permettant de manipuler les chemin d'acces aux fichiers et répertoires.

Auteur:
Adrien Boussicault
Marc Zipstein

Documentation des fonctions

char* MLV_build_path ( const char *  first_element,
  ... 
)

Construit en concaténant différents textes, une chaine de caractère représentant un chemin dont les séparateurs corespondent aux spécifications de la plateforme sur laquel s'execute le programme.

Bogue:
Cette fonction ne fait que concatener les differentes chaines en en mettant entre chaque chaine un separateur de repertoire compatible avec le systeme d'exploitation. Par contre, ce qui constitue le bug, il ne convertit pas chache chaine dans un format compatible avec celui du système d'exploitation.
Paramètres:
first_element La premiere chaîne à concatener
... les autres éléments à concatener
Renvoie:
Le chemin vérifiant les normes de la plateforme hôte.
Exemples:
advanced/12_paths.c.
char* MLV_build_path_v ( char **  elements  ) 

Même chose que MLV_build_path.

Paramètres:
elements les éléments à concatener ensemble
Renvoie:
Le chemin vérifiant les normes de la plateforme hôte.
char* MLV_get_base_name ( const char *  path  ) 

Renvoie la chaîne de caractères après le dernier séparteur / dans un chemin donné en paramètre.

Paramètres:
path Le chemin à analyser.
Renvoie:
Une chaîne de caractère.
Exemples:
advanced/12_paths.c.
const char* MLV_get_current_directory (  ) 

Determine le répertoire courant.

Renvoie:
Le chemin du répertire courant.
Exemples:
advanced/12_paths.c.
char* MLV_get_directory_name ( const char *  path  ) 

Renvoie la chaîne de caractère s'étendnant jusqu'au dernier séparateur / du chemin donné en paramètre.

Paramètres:
path Le chemin à analyser.
Renvoie:
Une chaîne de caractère.
Exemples:
advanced/12_paths.c.
const char* MLV_get_home_directory (  ) 

Determine le répertoire personnel de l'utilisateur courant.

Renvoie:
Le chemin du répertire personnel.
Exemples:
advanced/12_paths.c.
const char* MLV_get_temporary_directory (  ) 

Determine le répertoire temporaire.

Le répertoire temporaire est le repertoire dans lequel les applications ont ont le droit d'ajouter et de modifier des fichiers. Ce répertoire génaralement vidé lorqsue la machine est étteinte.

Renvoie:
Le chemin du répertire temporaire.
Exemples:
advanced/12_paths.c.
int MLV_path_exists ( const char *  path  ) 

Teste si le chemin corespond au chemin d'un fichier ou dossier existant.

Paramètres:
path Le chemin
Renvoie:
Renvoie 1 si le chemin est associé à un dossier ou un fichier existant, 0 sinon.
Exemples:
advanced/12_paths.c.
int MLV_path_is_a_directory ( const char *  path  ) 

Vérifie si un chemin est un associé à un répertoire.

Paramètres:
path Le chemin
Renvoie:
Renvoie 1 si le chemin est associé à un dossier, 0 sinon.
Exemples:
advanced/12_paths.c.
int MLV_path_is_a_file ( const char *  path  ) 

Vérifie si un chemin est un associé à un fichier.

Paramètres:
path Le chemin
Renvoie:
Renvoie 1 si le chemin est associé à un fichier, 0 sinon.
Exemples:
advanced/12_paths.c.
int MLV_path_is_absolute ( const char *  path  ) 

Teste si un chemin est absolu.

Paramètres:
path Le chemin
Renvoie:
1 si le chemin est absolue, 0 sinon.
Exemples:
advanced/12_paths.c.
int MLV_path_is_relative ( const char *  path  ) 

Teste si un chemin est relatif.

Paramètres:
path Le chemin
Exemples:
advanced/12_paths.c.