Main Content

userpath

既定のユーザーの作業フォルダーを表示または変更

ページ内をすべて折りたたむ

構文

userpath
userpath(newpath)
userpath('reset')
userpath('clear')

説明

例

userpath は、MATLAB® が起動時に検索パスに追加するユーザー固有のフォルダーを返します。文字ベクトルとして指定します。

例

userpath(newpath) は、検索パスのユーザー固有のフォルダーを newpath に設定します。userpath を使用して指定されたフォルダーは、直後および今後のセッションの起動時に検索パスに置かれます。MATLAB は、userpath によって前に指定したフォルダーを検索パスから削除します。

userpath('reset') は、検索パスのユーザー固有のフォルダーをプラットフォームの既定値に設定します。既定の userpath フォルダーはプラットフォームごとに異なります。

  • Windows® プラットフォーム — %USERPROFILE%/Documents/MATLAB

  • Mac プラットフォーム — $home/Documents/MATLAB

  • Linux® プラットフォーム — $home/Documents/MATLAB ($home/Documents が存在する場合)

MATLAB は、既定のフォルダーを直ちに検索パスに追加するだけでなく、それ以降のセッションの起動時にも検索パスに追加します。Windows および Mac プラットフォームでは、既定のフォルダーが存在しない場合は作成されます。Linux では、既定のフォルダーが存在しない場合は作成されません。

例

userpath('clear') は直ちに検索パスからユーザー固有のフォルダーを削除し、それ以降の MATLAB セッションでもこのフォルダーは検索されません。

例

すべて折りたたむ

この例では、userpath フォルダーが Windows プラットフォーム上で既定値 Documents\MATLAB に設定されていると仮定します。MATLAB を起動すると、現在のフォルダーが表示されます。

pwd
H:\Documents\MATLAB

この例で H は Documents があるドライブです。

現在のフォルダーが userpath フォルダーであることを確認します。

userpath
H:\Documents\MATLAB

検索パスを表示します。MATLAB は、userpath によって指定されたフォルダーを含む検索パスを返します。

path
MATLABPATH

	H:\Documents\MATLAB
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

userpath フォルダーが Windows プラットフォームの既定値 Documents\MATLAB に設定されていると仮定します。

この値を既定値から C:\Research_Project に変更します。

newpath = 'C:\Research_Project';
userpath(newpath)

検索パス上で変更の影響を表示します。

path
MATLABPATH

	C:\Research_Project
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

MATLAB は、userpath によって指定されたフォルダーを含む検索パスを表示します。MATLAB は、userpath を使用して新しいフォルダーが割り当てられると、自動的に userpath フォルダーの以前の値 H:\Documents\MATLAB を検索パスから削除します。

userpath フォルダーが既定値に設定されているが、起動時に検索パスに追加しないようにすると仮定します。

既定値が設定されていることを確認します。

userpath
H:\Documents\MATLAB

検索パス上にあることを確認します。

path
MATLABPATH

H:\Documents\MATLAB
C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

値をクリアします。

userpath('clear')

結果を確認します。

userpath
ans =
     ''

以前の userpath フォルダーが検索パスから削除されていることを確認します。

path
MATLABPATH

C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

メモ

userpath('clear') を使用した場合、起動フォルダーが検索パス上にない可能性があります。これは、userpath フォルダーを検索パスから削除し、変更を保存した場合にも生じることがあります。

入力引数

すべて折りたたむ

userpath フォルダーの新しい値。文字ベクトルまたは string スカラーとして指定します。newpath は絶対パスでなければなりません。

例: 'C:\myFolder'

データ型: char | string

制限

  • MATLAB Online™ では、userpath で指定されたフォルダーのみを表示できます。フォルダーの変更はサポートされていません。

ヒント

  • 起動フォルダーを指定するには、[基本設定] ウィンドウの [一般基本設定] ページにある [初期作業フォルダー] 基本設定を設定します。

  • MATLABPATH 環境変数に、検索パスに追加するフォルダーのリストを含めることができます。MATLAB は、MATLABPATH 環境変数で指定したフォルダーを、起動時に userpath フォルダーの下の検索パスに追加します。

バージョン履歴

R2008a で導入

参考

| | | | |

トピック