Contents Up Previous Next

Fonctions pour les fichiers

Fichiers à inclure

<wx/filefn.h>

Voir aussi

wxPathList
wxDir
wxFile
wxFileName

::wxDos2UnixFilename
::wxFileExists
::wxFileModificationTime
::wxFileNameFromPath
::wxFindFirstFile
::wxFindNextFile
::wxGetDiskSpace
::wxGetFileKind
::wxGetOSDirectory
::wxIsAbsolutePath
::wxDirExists
::wxPathOnly
::wxUnix2DosFilename
wxCHANGE_UMASK
::wxConcatFiles
::wxCopyFile
::wxGetCwd
::wxGetWorkingDirectory
::wxGetTempFileName
::wxIsWild
::wxMatchWild
::wxMkdir
::wxParseCommonDialogsFilter
::wxRemoveFile
::wxRenameFile
::wxRmdir
::wxSetWorkingDirectory
::wxSplitPath
::wxTransferFileToStream
::wxTransferStreamToFile


::wxDos2UnixFilename

void wxDos2UnixFilename(wxChar *s)

Converti un nom de fichier DOS en Unix en remplaçant les anti-slashes par des slashes.


::wxFileExists

bool wxFileExists(const wxString& filename)

Retourne vrai si le fichier existe et est un fichier réel.


::wxFileModificationTime

time_t wxFileModificationTime(const wxString& filename)

Retourne la date de la dernière modification d'un fichier donné.

La fonction retourne (time_t)-1 si une erreur est survenue (par exemple, si le fichier n'a pas été trouvé).


::wxFileNameFromPath

wxString wxFileNameFromPath(const wxString& path)

char * wxFileNameFromPath(char *path)

NB: Cette fonction est obsolète. MErci d'utiliser wxFileName::SplitPath à la place.

Retourne le nom de fichier ou un chemin complet. La seconde forme retourne un pointeur vers une zone temporaire qui ne doit pas être désallouée.


::wxFindFirstFile

wxString wxFindFirstFile(const char *spec, int flags = 0)

Cette fonction effectue une recherche dans un répertoire et retourne le premier fichier qui correspond au chemin spec, ou une chaîne de caractères vide. Utilisez wxFindNextFile pour obtenir le fichier correspondant suivant. Cette fonction ne retournera jamais le dossier "." ou le dossier parent "..".

Attention

Comme pour wx 2.5.2, ces fonctions ne sont pas sécuritaires au niveau de sthreads (elles utilisent des variables statiques). Vous voudrez probablement utiliser wxDir::GetFirst ou wxDirTraverser à la place.

spec peut contenir des jockers.

flags peut être wxDIR pour restreindre la recherche aux répertoires, wxFILE pour les fichiers, ou zéro pour les deux.

Par exemple:

  wxString f = wxFindFirstFile("/home/project/*.*");
  while ( !f.empty() )
  {
    ...
    f = wxFindNextFile();
  }

::wxFindNextFile

wxString wxFindNextFile()

Retourne le fichier suivant correspondant au chemin passé à wxFindFirstFile.

Voir wxFindFirstFile pour un exemple.


::wxGetDiskSpace

bool wxGetDiskSpace(const wxString& path, wxLongLong *total = NULL, wxLongLong *free = NULL)

Cette fonction retourne le nombre total d'octets et le nombre d'octets libres sur le disque contenant le répertoire path (il doit exister). Les deux paramètres total et free peuvent être NULL si l'information correspondante n'est pas voulue.

Retourne

true en cas de succès, false si une erreur est survenue (par exemple, le répertoire n'existe pas).

Portabilité

Cette fonction est implémeéntée pour Win32, Mac OS et les Unix génériques dont le système possède la fonction statfs().

Cette fonction est apparue pour la première fois dans wxWidgets 2.3.2.


::wxGetFileKind

wxFileKind wxGetFileKind(int fd)

wxFileKind wxGetFileKind(FILE *fp)

Retourne le type d'un fichier ouvert. Les valeurs possibles de retour sont:

enum wxFileKind
{
  wxFILE_KIND_UNKNOWN,
  wxFILE_KIND_DISK,     // a file supporting seeking to arbitrary offsets
  wxFILE_KIND_TERMINAL, // a tty
  wxFILE_KIND_PIPE      // a pipe
};

Fichier à inclure

<wx/filefn.h>


::wxGetOSDirectory

wxString wxGetOSDirectory()

Retourne le répertoire Windows sous Windows; sur les autres plateformes, retourne une chaine de caractères vide.


::wxIsAbsolutePath

bool wxIsAbsolutePath(const wxString& filename)

Retourne true si l'argument est un nom de fichier absolu, par exemple, avec un slashe ou un nom de disque au début.


::wxDirExists

bool wxDirExists(const wxChar *dirname)

Retourne true si dirname existe et est un répertoire.


::wxPathOnly

wxString wxPathOnly(const wxString& path)

Retourne la partie répertoire d'un chemin de fichier.


::wxUnix2DosFilename

void wxUnix2DosFilename(wxChar *s)

Cette fonction est dépréciée, utilisez wxFileName à la place.

Converti un nom de fichier Unix en Dos en remplaçant les slashes par des anti-slashes .


wxCHANGE_UMASK

wxCHANGE_UMASK(int mask)

Sous Unix, cette macro change le umask du processus courant à la valeur donnée, sauf s'il est égal à -1 auquel cas, rien n'est fait, et le restaure à sa valeur originale lors de la sortie du contexte. Elle agit en déclarant une variable qui définit umask à mask dans son constructeur et qui le restaure dans son destructeur.

Sous les autres plateformes, cette macro ne fait rien.


::wxConcatFiles

bool wxConcatFiles(const wxString& file1, const wxString& file2, const wxString& file3)

Concatène file1 et file2 en file3, retournant true en cas de succès.


::wxCopyFile

bool wxCopyFile(const wxString& file1, const wxString& file2, bool overwrite = true)

Copie file1 vers file2, retournant true en cas de succès. Si le paramètre overwrite vaut true (par défaut), le fichier destination est écrasé s'il existe, mais si overwrite vaut false, la fonction échoue dans ce cas.


::wxGetCwd

wxString wxGetCwd()

Retourne une chaine de caractères contenant le répertoire courant (ou le répertoire de travail).


::wxGetWorkingDirectory

wxString wxGetWorkingDirectory(char *buf=NULL, int sz=1000)

NB: Cette fonction est dépréciée: utilisez wxGetCwd à la place.

Copie le répertoire courant de travail dans l'éventuel tampon fourni, ou copie le répertoire courant de travail dans une nouvelle zone (que vous devez détruire vous-même) si le tampon est NULL.

sz est la taille du tampon s'il est fourni.


::wxGetTempFileName

char * wxGetTempFileName(const wxString& prefix, char *buf=NULL)

bool wxGetTempFileName(const wxString& prefix, wxString& buf)

NB: Ces fonctions sont obsolètes, merci d'utiliser wxFileName::CreateTempFileName à la place.


::wxIsWild

bool wxIsWild(const wxString& pattern)

Retourne true si pattern contient des jockers. Voir wxMatchWild.


::wxMatchWild

bool wxMatchWild(const wxString& pattern, const wxString& text, bool dot_special)

Retourne true si text correspond à pattern; si dot_special vaut true, les noms de fichiers commençant par un point ne sont pas pris en compte avec les caractères génériques. Voisr wxIsWild.


::wxMkdir

bool wxMkdir(const wxString& dir, int perm = 0777)

Crée le répertoire dir, et retourne true en cas de succès.

perm est le masque d'accès pour le répertoire pour les systèmes sur lesquels cela est supporté (Unix) et n'a aucun effet sur les autres.


::wxParseCommonDialogsFilter

int wxParseCommonDialogsFilter(const wxString& wildCard, wxArrayString& descriptions, wxArrayString& filters)

Analyse le jocker wildCard, et retourne le nombre de filtres. Retourne 0 si aucun ou si il y a eut un problème. Les tableaux wxArrayString vont contenir un nombre égal d'éléments trouvés avant une éventuelle erreur. Sur les plateformes sur lesquelles les dialogues natifs ne gèrent qu'un seul filtre par entrée, les entrées dans les tableaux sont automatiquement ajustées. wildCard est de la forme:

 "Tous les fichiers (*)|*|Fichiers Images (*.jpeg *.png)|*.jpg;*.png"

::wxRemoveFile

bool wxRemoveFile(const wxString& file)

Supprime file, retournant true en cas de succès.


::wxRenameFile

bool wxRenameFile(const wxString& file1, const wxString& file2, bool overwrite = true)

Renome file1 en file2, retournant true en cas de succès.

Si le paramètre overwrite vaut true (par defaut), le fichier destination est écrasé s'il existe, mais si overwrite vaut false, la fonction échoue dans ce cas.


::wxRmdir

bool wxRmdir(const wxString& dir, int flags=0)

Supprime le répertoire dir, retournant true en cas de succès. Ne marche pas sous VMS.

Le paramètre flags est réservé pour une utilisation future.

MErci de noter qu'il existe une fonction wxRmDir() qui encapsule la fonction standard POSIX rmdir() et retourne un code d'erreur entier au lieu d'une valeur booléenne (mais qui sinon,n est identique à wxRmDir); ne confondez pas ces deux fonctions.


::wxSetWorkingDirectory

bool wxSetWorkingDirectory(const wxString& dir)

Défini le répertoire courant de travail, retournant true si l'opération a réussi. Sous Ms Windows, le lecteur courant est également changé si dir contient une spécification de lecteur.


::wxSplitPath

void wxSplitPath(const char * fullname, wxString * path, wxString * name, wxString * ext)

NB: Cette fonction est obsolète, merci d'utiliser wxFileName::SplitPath à la place.

Cette fonction coupe un chemin de fichier complet en sous-composants : le chemin (incluant une éventuelle spécification de disque/lecteur sous Windows), le nom et l'extension. Chacun des paramètres de sortie (path, name ou ext) peut être NULL si vous n'êtes pas intéressé par sa valeur.

wxSplitPath() va gérer correctement les noms de fichiers avec à la fois des séparateurs Unix et Dos sous Windows, toutefois, cette fonction ne va pas considérer les anti-slashes comme des séparateurs sous Unix (où les anti-slashes ssont considérés comme un caractère de nom de fichier valide).

En entrée, filename ne doit pas être NULL (mais il peut par contre être vide).

En retour, path contient le chemin vers le fichiers (sans le dernier séparateur), name contient le nom du fichier et ext contient l'extension du fichier sans le point. Ces trois variables peuvent être vides si le composant correspondant l'est. L'ancien contenu de ces variables sera écrasé dans tous les cas (si les pointeurs ne sont pas NULL).


::wxTransferFileToStream

bool wxTransferFileToStream(const wxString& filename, ostream& stream)

Copie le fichier donné vers stream. Utile lors de la conversion d'une ancienne application pour utiliser les flux (dans le framework document/vue, par exemple).

Fichiers à inclure

<wx/docview.h>


::wxTransferStreamToFile

bool wxTransferStreamToFile(istream& stream const wxString& filename)

Copie le flux donné vers le fichier filename. Utile pour la conversion d'une ancienne application pour utiliser les flux (dans le framework document/vue, par exemple).

Fichiers à inclure

<wx/docview.h>