fileread

ファイルの内容をテキストとして読み取る

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

構文

text = fileread(filename)
text = fileread(filename,Encoding=encoding)

説明

text = fileread(filename) はファイル filename の内容を文字ベクトルとして返します。

例

text = fileread(filename,Encoding=encoding) は encoding で指定したエンコードを使用して filename を開きます。

例

例

すべて折りたたむ

ライブ スクリプトを開く

ファイルを読み取って対象のテキストを検索します。

まず、ファイル fileread.m を文字ベクトルに読み取ります。

filetext = fileread('fileread.m');

次に、検索するテキストを定義します。

expr = '[^\n]*fileread[^\n]*';

テキスト 'fileread' を含むすべての行を検出して返します。

matches = regexp(filetext,expr,'match');

一致した最初の行を表示します。

disp(matches{1})
function out = fileread(filename,args)

入力引数

すべて折りたたむ

読み取るファイルの名前。ファイル拡張子を含む string スカラーまたは文字ベクトルとして指定します。fileread は自動文字セット検出を使用してファイルのエンコードを判別します。

UNIX® システムでは、filename が '~/' または '~username/' で開始されている場合、関数 fileread によって、パスが現在のユーザーまたは指定されているユーザーのホーム ディレクトリにそれぞれ展開されます。

ファイルの場所に応じて、filename は次の形式のいずれかをとります。

現在のフォルダー、または MATLAB® パス上のフォルダー

ファイル名を filename で指定します。

読み取りアクセスでファイルを開く場合にそのファイルが現在のフォルダーに存在しなければ、fileread によって MATLAB 検索パスに沿った検索が実行されます。

例: "sample_file.txt"

その他のフォルダー

ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、filename に絶対パス名または相対パス名を指定します。

例: "C:\myFolder\myFile.sample_file.txt"

例: "myFolder\sample_file.txt"

インターネット URL (R2024b 以降)

ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、filename にはプロトコル タイプ "http://" または "https://" が含まれていなければなりません。

例: "http://hostname/path_to_file/my_data.csv"

リモートの場所

リモートの場所に保存されたファイルの場合、filename は次の形式の URL として指定されたファイルの絶対パスを含まなければなりません。

scheme_name://path_to_file/my_file.ext

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所scheme_name
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs
HDFS™hdfs

クラウド ファイル システムを使用している場合は、リモート ファイル システムと通信するための環境変数を設定します。詳細については、リモート データの操作を参照してください。

例: "s3://bucketname/path_to_file/sample_file.txt"

例: "myFile.dat"

ファイルに関連付けられた文字エンコード スキーム。"" または次の表に示す値のいずれかのような標準の文字エンコード スキーム名として指定します。エンコードを指定しない場合、またはエンコードを "" として指定した場合、関数 fileread は MATLAB の既定のエンコードを使用してファイルを読み取ります。

"Big5"

"ISO-8859-1"

"windows-874"

"Big5-HKSCS"

"ISO-8859-2"

"windows-949"

"CP949"

"ISO-8859-3"

"windows-1250"

"EUC-KR"

"ISO-8859-4"

"windows-1251"

"EUC-JP"

"ISO-8859-5"

"windows-1252"

"EUC-TW"

"ISO-8859-6"

"windows-1253"

"GB18030"

"ISO-8859-7"

"windows-1254"

"GB2312"

"ISO-8859-8"

"windows-1255"

"GBK"

"ISO-8859-9"

"windows-1256"

"IBM866"

"ISO-8859-11"

"windows-1257"

"KOI8-R"

"ISO-8859-13"

"windows-1258"

"KOI8-U"

"ISO-8859-15"

"US-ASCII"

 

"Macintosh"

"UTF-8"

 

"Shift_JIS"

 

例: Encoding="system" はシステムの既定のエンコードを使用します。

制限

  • MATLAB では、認証が必要なインターネット URL はサポートされていません。

  • MATLAB Online™ では Microsoft® OneDrive™ ファイルおよびフォルダーに関連付けられたインターネット URL はサポートされていますが、MATLAB のインストール バージョンではローカル OneDrive ファイルのみがサポートされています。

拡張機能

すべて展開する

バージョン履歴

R2006a より前に導入

すべて展開する

参考

| | | | | | |