MATLAB Function Reference

textread

從文件檔案中讀取格式化的資料

    Graphical Interface

除了使用 textread 指令外，也可使用輸入精靈（Import Wizard）。欲執行輸入精靈（Import Wizard），請選擇檔案（File）中的輸入資料（Import data）。

Syntax

[A,B,C,...] = textread('filename','format')
[A,B,C,...] = textread('filename','format',N)
[...] = textread(...,'param','value',...)

Description

[A,B,C,...] = textread('filename','format') 依照 format 格式讀取檔案資料 str 並存入 A, B, C 等變數，直到讀完整個檔案資料。textread 指令對於讀取已知格式的檔案是相當有用的。不管是 fixed 還是 free 的檔案格式都可以處理。

textread 指令對應、轉換輸入的字元組。每一筆輸入欄位即為沒有空白字元而延伸到下個空白字元或是定義符號的字串，或是最大欄位長度的字串。連續出現的定義符號是有特殊意義的，但是連續的空白字元則會被視為只有一個空白字元。

依字串 format 來決定回傳值的個數及資料型態。回傳值的個數和字串 format 中決定項目的個數是相同的。同時，字串 format 支援 C 語言中 fscanf 程序的協定。字串 format 的使用方法列在下表。若在字串 format 中有空白字元，則一律忽略。

[A,B,C,...] = textread('filename','format',N) 依 format 格式重覆 N 次讀取檔案，N 為一大於 0 整數，若 N 小於 0 ，則 textread 將讀完整個檔案才結束。

[...] = textread(...,'param','value',...) 依照 param/value 來決定 textread 的功用，param/value 的用法列在下面的表格中。

param	value	Action
whitespace	Any from the list below:	將字元向量視為空白字元。預設為 ' \b\t'。
	' ' \b \n \r \t	空白字元 倒退符號 換行符號 Carriage return Horizontal tab
delimiter	Delimiter 字元	指定定義符號，預設值為空字串。
expchars	Exponent 字元	預設值為 eEdD.
bufsize	正整數	以位元組定義字串的最大長度，預設值是 4095。
headerlines	正整數	忽略檔案起始的特定行數。
commentstyle	matlab	忽略在 % 之後的字元。
commentstyle	shell	忽略在 # 之後的字元。
commentstyle	c	忽略在 /* 和 */ 之間的字元。
commentstyle	c++	忽略在 // 之後的字元。

註釋    當使用 textread 讀取連續的空白字元，它會將其視為只有一個空白字元。當讀取連續的定義符號時，它會將每一個定義符號都視為獨立個體的。

Examples

範例 1 - 使用 % 讀取檔案的欄位

檔名為 mydata.dat 的檔案其第一行為

Sally    Type1 12.34 45 Yes

使用 % 格式讀取檔案的第一行。

[names,types,x,y,answer] = textread('mydata.dat','%s %s %f ...
    %d %s',1)

傳回值為

names = 
    'Sally'
types = 
    'Type1'
x =
  12.34000000000000
y =
    45
answer = 
    'Yes'

範例 2 - 讀取檔案內容，但不包括浮點數

檔名為 mydata.dat 的檔案其第一行為

Sally    Type1 12.34 45 Yes

讀取檔案的第一行，並忽略浮點數。

[names,types,y,answer] = textread('mydata.dat','%9c %5s %*f ... 
%2d %3s',1)

傳回值為

names =
Sally    
types = 
    'Type1'
y =
    45
answer = 
    'Yes'

在這個範例中，format 字串 %*f 指令造成 textread 忽略了檔案中的浮點數 12.34。

範例 3 - 使用文字去省略讀取相配對應的字體

檔名為 mydata.dat 的檔案其第一行為

Sally    Type1 12.34 45 Yes

讀取檔案的第一行，並忽略第二欄的 Type。

[names,typenum,x,y,answer] = textread('mydata.dat','%s Type%d %f 
%d %s',1)

傳回值為

names = 
    'Sally'
typenum =
     1
x =
  12.34000000000000
y =
    45
answer = 
    'Yes'

在這個範例中，format 字串 Type%d 指令造成了第二欄的字體 Type 被忽略，而第二欄剩下的值會以正整數的型態被讀取，也就是 1。

範例 4 - 將 M 檔案讀進存取字串的陣列中

將檔案 fft.m 讀進存取字串的陣列 file 中。

file = textread('fft.m','%s','delimiter','\n','whitespace','');

See Also

dlmread, fscanf

Text Properties

textwrap