Filesystem library

Fusionné dans la norme ISO C++ La fonctionnalité décrite sur cette page a été fusionnée dans la norme principale ISO C++ à partir de 03/2016 ; voir la bibliothèque filesystem (depuis C++17)

La bibliothèque Filesystem, ISO/IEC TS 18822:2015, fournit des fonctionnalités pour effectuer des opérations sur les systèmes de fichiers et leurs composants, tels que les chemins, les fichiers réguliers et les répertoires.

Cette bibliothèque est une spécification technique optionnelle et peut être indisponible si un système de fichiers hiérarchique n'est pas accessible à l'implémentation, ou s'il ne fournit pas les capacités nécessaires. Certaines fonctionnalités peuvent ne pas être disponibles si elles ne sont pas prises en charge par le système de fichiers sous-jacent (par exemple, le système de fichiers FAT n'a pas de liens physiques, de liens symboliques et d'autres fonctionnalités).

Le comportement est indéfini si les appels aux fonctions de cette bibliothèque introduisent une course au système de fichiers , c'est-à-dire lorsque plusieurs threads, processus ou ordinateurs entrelacent l'accès et la modification du même objet dans un système de fichiers.

Cette bibliothèque est directement basée sur boost.filesystem , qui est actuellement disponible sur plus de compilateurs et plateformes que cette spécification technique expérimentale.

Table des matières 1 Définitions globales de la bibliothèque 2 Classes 3 Fonctions non membres 3.1 Types de fichiers 4 Voir aussi

Définitions à l'échelle de la bibliothèque

• fichier : un objet du système de fichiers qui contient des données, pouvant être écrit, lu, ou les deux. Les fichiers ont des noms, des attributs, dont l'un est le type de fichier :

• répertoire : un fichier qui agit comme un conteneur d'entrées de répertoire, qui identifient d'autres fichiers (dont certains peuvent être d'autres répertoires imbriqués). Lorsqu'on discute d'un fichier particulier, le répertoire dans lequel il apparaît comme une entrée est son répertoire parent . Le répertoire parent peut être représenté par le chemin relatif ".." .
• lien physique : une entrée de répertoire qui associe un nom à un fichier existant. Si plusieurs liens physiques sont supportés, le fichier est supprimé après la suppression du dernier lien physique pointant vers lui.
• lien symbolique : une entrée de répertoire qui associe un nom à un chemin, qui peut exister ou non.
• fichier régulier : un fichier qui n'est pas l'un des autres types de fichiers.

• nom de fichier : une chaîne de caractères qui nomme un fichier. Les caractères autorisés, la sensibilité à la casse, la longueur maximale et les noms interdits sont définis par l'implémentation. Les noms . (point) et .. (point-point) ont une signification spéciale au niveau de la bibliothèque.
• chemin : séquence d'éléments qui identifie un fichier. Il commence par un root-name optionnel (par ex. "C:" ou "//server" ), suivi d'un root-directory optionnel (par ex. "/" sur Unix), suivi d'une séquence de zéro ou plusieurs noms de fichiers (dont tous sauf le dernier doivent être des répertoires ou des liens vers des répertoires). Le format natif (par ex. quels caractères sont utilisés comme séparateurs) et l'encodage des caractères de la représentation sous forme de chaîne d'un chemin (le pathname ) sont définis par l'implémentation, cette bibliothèque fournit une représentation portable des chemins.

• chemin absolu : un chemin qui identifie sans ambiguïté l'emplacement d'un fichier.
• chemin canonique : un chemin absolu qui n'inclut aucun lien symbolique, "." ou ".." .
• chemin relatif : un chemin qui identifie un fichier relativement à un certain emplacement du système de fichiers. Les noms de chemin spéciaux . (point, "répertoire courant") et .. (point-point, "répertoire parent") sont des chemins relatifs.

Classes

path	représente un chemin (classe)
filesystem_error	une exception levée lors d'erreurs du système de fichiers (classe)
directory_entry	une entrée de répertoire (classe)
directory_iterator	un itérateur vers le contenu du répertoire (classe)
recursive_directory_iterator	un itérateur vers le contenu d'un répertoire et de ses sous-répertoires (classe)
file_status	représente le type de fichier et les permissions (classe)
space_info	informations sur l'espace libre et disponible sur le système de fichiers (classe)
file_type	le type d'un fichier (énumération)
perms	identifie les permissions du système de fichiers (énumération)
copy_options	spécifie la sémantique des opérations de copie (énumération)
directory_options	options pour l'itération du contenu des répertoires (énumération)
file_time_type	représente les valeurs temporelles des fichiers (typedef)

Fonctions non membres

absolute system_complete	compose un chemin absolu convertit un chemin en chemin absolu en reproduisant le comportement spécifique au système d'exploitation (fonction)
canonical	compose un chemin canonique (fonction)
copy	copie des fichiers ou répertoires (fonction)
copy_file	copie le contenu du fichier (fonction)
copy_symlink	copie un lien symbolique (fonction)
create_directory create_directories	crée un nouveau répertoire (fonction)
create_hard_link	crée un lien physique (fonction)
create_symlink create_directory_symlink	crée un lien symbolique (fonction)
current_path	retourne le répertoire de travail actuel (fonction)
exists	vérifie si le chemin fait référence à un objet existant du système de fichiers (fonction)
equivalent	vérifie si deux chemins font référence au même objet du système de fichiers (fonction)
file_size	retourne la taille d'un fichier (fonction)
hard_link_count	retourne le nombre de liens physiques référençant le fichier spécifique (fonction)
last_write_time	obtient ou définit l'heure de la dernière modification des données (fonction)
permissions	modifie les permissions d'accès au fichier (fonction)
read_symlink	obtient la cible d'un lien symbolique (fonction)
remove remove_all	supprime un fichier ou un répertoire vide supprime un fichier ou un répertoire et tout son contenu, récursivement (function)
rename	déplace ou renomme un fichier ou un répertoire (fonction)
resize_file	modifie la taille d'un fichier régulier par troncation ou remplissage par des zéros (fonction)
space	détermine l'espace libre disponible sur le système de fichiers (fonction)
status symlink_status	détermine les attributs du fichier détermine les attributs du fichier, en vérifiant la cible du lien symbolique (fonction)
temp_directory_path	retourne un répertoire approprié pour les fichiers temporaires (fonction)
Types de fichiers
is_block_file	vérifie si le chemin donné fait référence à un périphérique de bloc (fonction)
is_character_file	vérifie si le chemin donné fait référence à un périphérique de caractères (fonction)
is_directory	vérifie si le chemin donné fait référence à un répertoire (fonction)
is_empty	vérifie si le chemin donné fait référence à un fichier ou répertoire vide (fonction)
is_fifo	vérifie si le chemin donné fait référence à un tube nommé (fonction)
is_other	vérifie si l'argument fait référence à un fichier autre (fonction)
is_regular_file	vérifie si l'argument fait référence à un fichier régulier (fonction)
is_socket	vérifie si l'argument fait référence à un socket IPC nommé (fonction)
is_symlink	vérifie si l'argument fait référence à un lien symbolique (fonction)
status_known	vérifie si le statut du fichier est connu (fonction)

Voir aussi

Documentation C++ pour Bibliothèque Filesystem (C++17)