fullfile

Créer un nom de fichier complet à partir de ses éléments

Syntaxe

f = fullfile(filepart1,...,filepartN)

Description

f = fullfile(filepart1,...,filepartN) crée une spécification de fichier complète à partir des noms de dossier et de fichier spécifiés. fullfile insère des séparateurs de fichier dépendants de la plateforme si nécessaire mais n’ajoute pas de séparateur de fin. Sur les plateformes Windows^®, le séparateur de fichier est le caractère backslash (\). Sur les autres plateformes, le séparateur de fichier peut être un caractère différent.

fullfile remplace tous les slashes vers l’avant (/) par des backslashes (\) sous Windows. Sur les plateformes UNIX^®, le backslash (\) est un caractère valide dans les noms de fichier et n’est pas remplacé.

fullfile ne coupe pas les séparateurs de fin ni de début. fullfile réduit les séparateurs de fichier répétés internes, sauf s’ils figurent au début de la spécification de fichier complète. fullfile réduit également les répertoires relatifs indiqués par un point, sauf s’ils figurent à la fin de la spécification de fichier complète. Les répertoires relatifs indiqués par un point double ne sont pas réduits.

Exemples

Créer un chemin de fichier complet sous Windows

fullfile renvoie un vecteur de caractères contenant le chemin complet du fichier. Sur les plateformes Windows®, le séparateur de fichier est le caractère backslash (\).

f = fullfile('myfolder','mysubfolder','myfile.m')

f =

    'myfolder\mysubfolder\myfile.m'

Créer un chemin de fichier complet sous UNIX

fullfile renvoie un vecteur de caractères contenant le chemin complet du fichier. Sur les plateformes UNIX®, le séparateur de fichier est le caractère slash vers l’avant (/).

f = fullfile('myfolder','mysubfolder','myfile.m')

f = 
'myfolder/mysubfolder/myfile.m'

Créer des chemins de fichiers multiples sous Windows

fullfile renvoie un cell array contenant les chemins des fichiers myfile1.m et myfile2.m.

f = fullfile('c:\','myfiles','matlab',{'myfile1.m';'myfile2.m'})

f =

  2×1 cell array

    'c:\myfiles\matlab\myfile1.m'
    'c:\myfiles\matlab\myfile2.m'

Réduire les séparateurs de fichier et les points sous Windows

Créez des chemins de dossier avec des séparateurs de fichier et des points.

fullfile ne coupe pas les séparateurs de fichier de début ni de fin. filesep renvoie le caractère de séparation de fichier propre à la plateforme.

f = fullfile('c:\','myfiles','matlab',filesep)

f =

c:\myfiles\matlab\

fullfile réduit les séparateurs de fichier répétés, sauf s’ils figurent au début de la spécification de fichier complète.

f = fullfile('c:\folder1', '\\\folder2\\')

f =

c:\folder1\folder2\

fullfile réduit les répertoires relatifs indiqués par un point, sauf s’ils figurent à la fin de la spécification de fichier complète. Les répertoires relatifs indiqués par un point double ne sont pas réduits.

f = fullfile('c:\folder1', '.\folder2', '..\folder3\.')

f =

c:\folder1\folder2\..\folder3\.

Arguments d'entrée

filepart1,...,filepartN — Noms de dossier ou de fichier

vecteurs de caractères | tableaux de chaînes de caractères | cell arrays de vecteurs de caractères

Noms de dossier ou de fichier, spécifiés sous forme de vecteurs de caractères, de tableaux de chaînes de caractères ou de cell arrays de vecteurs de caractères. Les cell arrays et chaînes de caractères non scalaires doivent être de même taille.

Exemple : fullfile('c:\','user','docs')

Exemple : fullfile('\\','Server01','user','docs')

Exemple : fullfile('home','users','docs',{'myfile.m', 'myfile2.m'})

Types de données : char | cell | string

Arguments de sortie

f — spécification de fichier complète

tableau de caractères | Tableau de chaînes de caractères | cell array de vecteurs de caractères

Spécification de fichier complète, renvoyée sous forme de tableau de caractères, de tableau de chaînes de caractères ou de cell array de vecteurs de caractères. Si l’un des arguments en entrée est un tableau de chaînes de caractères, f est un tableau de chaînes de caractères. Dans le cas contraire, si l’un des arguments en entrée est un cell array de vecteurs de caractères, f est un cell array de vecteurs de caractères. Autrement, f est un tableau de caractères.

Types de données : char | cell | string

Conseils

• Pour fractionner un nom de fichier complet en différents éléments de dossier, utilisez la fonction split.

Capacités étendues

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Si l’un des arguments en entrée est une chaîne de caractères, toutes les autres entrées doivent être des vecteurs de caractères, des string scalars ou un cell array à un seul élément contenant un vecteur de caractères ou une chaîne de caractères.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

Historique des versions

Introduit avant R2006a

Voir aussi

fileparts | filesep | path | pathsep | genpath | split