addpath

Add folders to search path

collapse all in page

Syntax

  • addpath(folderName1,...,folderNameN)
    example
  • addpath(folderName1,...,folderNameN,position)
    example

Description

example

addpath(folderName1,...,folderNameN) adds the specified folders to the top of the search path for the current MATLAB® session.

example

addpath(folderName1,...,folderNameN,position) adds the specified folders to the top or bottom of the search path, as specified by position.

example

addpath(___,'-frozen') additionally disables folder change detection for folders being added in Windows®. Use this syntax with any of the arguments in previous syntaxes. You can specify '-frozen' and position in either order. Use this syntax to conserve Windows change notification resources (Windows only). For more information, type help changenotification in the Command Window.

example

oldpath = addpath(___) additionally returns the path prior to adding the specified folders.

Examples

collapse all

Open Script

Create a folder, add it to the top of your search path, and then save the search path for future MATLAB® sessions.

mkdir('matlab/myfiles')
addpath('matlab/myfiles')
savepath matlab/myfiles/pathdef.m
Open Script

Create the folder matlab/myfiles and add it to the end of the search path.

mkdir('matlab/myfiles')
addpath('matlab/myfiles','-end')
Open Script

Add matlab/myfiles and its subfolders to the search path.

Create the folder matlab/myfiles and call genpath inside of addpath to add all subfolders of matlab/myfiles to the search path.

mkdir('matlab/myfiles')
addpath(genpath('matlab/myfiles'))
Open Script

On Windows®, create the folder matlab/myfiles. Then, add it to the top of the search path, disable folder change notification, and return the search path before adding the folder.

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

Input Arguments

collapse all

Folder names to add to the search path, specified as one or more character vectors. Use the full path name for each folder. Use genpath with addpath to add all subfolders of folderName.

Example: 'c:\matlab\work'

Example: '/home/user/matlab'

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

Position on the search path, specified as one of the following:

Value of position

Description

'-begin'

Add specified folders to the top of the search path.

'-end'

Add specified folders to the bottom of the search path.

Output Arguments

collapse all

Path prior to the addition of folders, returned as a character vector.

More About

collapse all

Tips

  • To save the newly modified search path for future MATLAB sessions, use the savepath function. Alternatively, use addpath statements in a startup.m file to modify the search path programmatically at startup.

  • If you use addpath within a local function, the path change persists after program control returns from the function. That is, the scope of the path change is global.

See Also

| | | |

Introduced before R2006a

Was this topic helpful?
MATLAB Documentation
Other Documentation
Support