addpath

Ajouter des dossiers au chemin de recherche

réduire tous les éléments de la page

Syntaxe

addpath(folderName1,...,folderNameN)
addpath(folderName1,...,folderNameN,position)
addpath(___,'-frozen')
oldpath = addpath(___)

Description

addpath(folderName1,...,folderNameN) ajoute les dossiers spécifiés en haut du chemin de recherche pour la session MATLAB® en cours.

Si l’entrée est un ensemble de dossiers séparés par des séparateurs de chemin, chacun des dossiers spécifiés est ajouté.

exemple

addpath(folderName1,...,folderNameN,position) ajoute les dossiers spécifiés en haut ou en bas du chemin de recherche selon ce qui est spécifié par position.

exemple

addpath(___,'-frozen') désactive également la détection de modification de dossier pour les dossiers ajoutés. Lorsque la détection de modification de dossier est désactivée pour un dossier, MATLAB ne détecte pas les modifications apportées à ce dossier en dehors de MATLAB.

Utilisez cette syntaxe avec n’importe quel argument des syntaxes précédentes. Vous pouvez spécifier '-frozen' et position dans l’ordre de votre choix.

exemple

oldpath = addpath(___) renvoie également le chemin avant d’ajouter les dossiers spécifiés.

exemple

Exemples

réduire tout

Ouvrir le live script

Créez un dossier, ajoutez-le en haut de votre chemin de recherche puis enregistrez le chemin de recherche pour les sessions MATLAB® ultérieures. 

mkdir('matlab/myfiles')   
addpath('matlab/myfiles')  
savepath matlab/myfiles/pathdef.m
Ouvrir le live script

Créez le dossier matlab/myfiles et ajoutez-le à la fin du chemin de recherche. 

mkdir('matlab/myfiles')
addpath('matlab/myfiles','-end')
Ouvrir le live script

Ajoutez matlab/myfiles et ses sous-dossiers au chemin de recherche.

Créez le dossier matlab/myfiles et appelez genpath à l’intérieur de addpath pour ajouter tous les sous-dossiers de matlab/myfiles au chemin de recherche.

mkdir('matlab/myfiles')
addpath(genpath('matlab/myfiles'))
Ouvrir le live script

Créez le dossier matlab/myfiles. Ensuite, ajoutez-le en haut du chemin de recherche, désactivez la notification de modification de dossier et renvoyez le chemin de recherche avant d’ajouter le dossier.

mkdir('matlab/myfiles')
oldpath = addpath('matlab/myfiles','-frozen');

La désactivation de la notification de modification de dossier n’est pas supportée dans MATLAB® Online™.

Arguments d'entrée

réduire tout

Noms des dossiers à ajouter au chemin de recherche, spécifiés sous forme d’un ou plusieurs vecteurs de caractères ou string scalars. Indiquez le nom de chemin complet pour chaque dossier. Utilisez genpath avec addpath pour ajouter tous les sous-dossiers de folderName.

Exemple : 'c:\matlab\work'

Exemple : '/home/user/matlab'

Exemple : '/home/user/matlab','/home/user/matlab/test'

MATLAB résout tous les noms de chemin contenant « . », « .. » et des liens symboliques à leur emplacement cible avant de les ajouter au chemin. Cela garantit que chaque entrée du chemin MATLAB représente un emplacement de dossier unique. Par exemple, si vous spécifiez c:\matlab\..\work, MATLAB ajoute le dossier c:\work au chemin.

Types de données : char | string

Position sur le chemin de recherche, spécifiée sous une des formes suivantes :

Valeur de position

Description

'-begin'

Ajoute les dossiers spécifiés en haut du chemin de recherche.

'-end'

Ajoute les dossiers spécifiés en bas du chemin de recherche.

Arguments de sortie

réduire tout

Chemin avant l’ajout des dossiers, renvoyé sous forme d’un vecteur de caractères.

Conseils

  • Pour enregistrer le chemin de recherche nouvellement modifié pour les sessions MATLAB ultérieures, utilisez la fonction savepath.

  • Pour modifier le chemin de recherche de manière programmatique au démarrage, utilisez des instructions addpath dans un fichier startup.m. Pour plus d’informations, consultez Add Folders to the MATLAB Search Path at Startup.

Algorithmes

Si vous utilisez addpath dans une fonction locale, la modification du chemin est conservée après que le contrôle du programme a fini de traiter la fonction. En d’autres termes, la modification du chemin a une portée globale.

Historique des versions

Introduit avant R2006a

Voir aussi

| | | |

Rubriques