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)

入力引数

すべて折りたたむ

`filename` — 読み取るファイルの名前
文字ベクトルまたは string スカラー

読み取るファイルの名前。ファイル拡張子を含む文字ベクトルまたは 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'

リモートの場所

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

scheme_name://path_to_file/my_file.ext

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

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

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

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

例: 'myFile.dat'

データ型: char | string

`encoding` — 文字エンコードスキーム
`""` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

ファイルに関連付けられた文字エンコードスキーム。"" または次の表に示す値のいずれかのような標準の文字エンコードスキーム名として指定します。エンコードを指定しない場合、またはエンコードを "" として指定した場合、関数 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" はシステムの既定のエンコードを使用します。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

関数 fileread によりファイル全体を読み取る場合、すべてのデータがコード生成に利用可能な最大配列に収まらなければなりません。
関数 fileread のコードジェネレーターは、ソースまたは出力の char 値を符号付き 8 ビット整数として扱います。0 ～ 127 の値のみを使用してください。

スレッドベースの環境
MATLAB® の `backgroundPool` を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の `ThreadPool` を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2006a より前に導入

すべて展開する

R2022b: スレッドベースの環境での関数の使用

この関数はスレッドベースの環境をサポートしています。

参考