textscan

读取包含浮点数的字符向量。

chr = '0.41 8.24 3.57 6.24 9.27';
C = textscan(chr,'%f');

formatSpec 中的设定符 '%f' 指示 textscan 将 chr 中的每个字段与一个双精度浮点数进行匹配。

显示元胞数组 C 的内容。

celldisp(C)

 
C{1} =
 
    0.4100
    8.2400
    3.5700
    6.2400
    9.2700

 

读取相同字符向量，将每个值截短至一位小数。

C = textscan(chr,'%3.1f %*1d');

设定符 %3.1f 指示字段宽度为 3 位数，精度为 1。textscan 函数读取全部 3 位数，包括小数点和小数点后的 1 位数。设定符 %*1d 指示 textscan 跳过其余位数。

显示元胞数组 C 的内容。

celldisp(C)

 
C{1} =
 
    0.4000
    8.2000
    3.5000
    6.2000
    9.2000

 

读取一个表示一组十六进制数的字符向量。表示十六进制数的文本包括数字 0-9，字母 a-f 或 A-F，以及可选的前缀 0x 或 0X。

要将 hexnums 中的字段与十六进制数匹配，请使用 '%x' 设定符。textscan 函数将字段转换为无符号 64 位整数。

hexnums = '0xFF 0x100 0x3C5E A F 10';
C = textscan(hexnums,'%x')

C = 1×1 cell array
    {6×1 uint64}

将 C 的内容显示为行向量。

transpose(C{:})

ans = 1×6 uint64 row vector

     255     256   15454      10      15      16

您可以将字段转换为 8、16、32 或 64 位的有符号或无符号整数。要将 hexnums 中的字段转换为有符号 32 位整数，请使用 '%xs32' 设定符。

C = textscan(hexnums,'%xs32');
transpose(C{:})

ans = 1×6 int32 row vector

     255     256   15454      10      15      16

您还可以指定用来解释输入的字段宽度。在这种情况下，前缀将计入字段宽度。例如，如果您将字段宽度设置为三，如在 %3x 中所示，则 textscan 将文本 '0xAF 100' 拆分为三个文本片段，即 '0xA'、'F' 和 '100'。它将这三个文本片段视为不同的十六进制数。

C = textscan('0xAF 100','%3x');
transpose(C{:})

ans = 1×3 uint64 row vector

    10    15   256

读取一个表示一组二进制数的字符向量。表示二进制数的文本包括数字 0 和 1，以及可选的前缀 0b 或 0B。

要将 binnums 中的字段与二进制数匹配，请使用 '%b' 设定符。textscan 函数将字段转换为无符号 64 位整数。

binnums = '0b101010 0b11 0b100 1001 10';
C = textscan(binnums,'%b')

C = 1×1 cell array
    {5×1 uint64}

将 C 的内容显示为行向量。

transpose(C{:})

ans = 1×5 uint64 row vector

   42    3    4    9    2

您可以将字段转换为 8、16、32 或 64 位的有符号或无符号整数。要将 binnums 中的字段转换为有符号 32 位整数，请使用 '%bs32' 设定符。

C = textscan(binnums,'%bs32');
transpose(C{:})

ans = 1×5 int32 row vector

   42    3    4    9    2

您还可以指定用来解释输入的字段宽度。在这种情况下，前缀将计入字段宽度。例如，如果您将字段宽度设置为三，如在 %3b 中所示，则 textscan 将文本 '0b1010 100' 拆分为三个文本片段，即 '0b1'、'010' 和 '100'。它将这三个文本片段视为不同的二进制数。

C = textscan('0b1010 100','%3b');
transpose(C{:})

ans = 1×3 uint64 row vector

   1   2   4

加载数据文件，并读取具有适当类型的每一列。

加载文件 scan1.dat 并在文本编辑器中预览其内容。屏幕截图如下所示。

 filename = 'scan1.dat';

打开文件，用正确的转换设定符读取每一列。textscan 返回一个 1-by-9 元胞数组 C。

fileID = fopen(filename);
C = textscan(fileID,'%s %s %f32 %d8 %u %f %f %s %f');
fclose(fileID);
whos C

  Name      Size            Bytes  Class    Attributes

  C         1x9              2393  cell               

查看 C 中的每个元胞的 MATLAB® 数据类型。

C

C=1×9 cell array
    {3×1 cell}    {3×1 cell}    {3×1 single}    {3×1 int8}    {3×1 uint32}    {3×1 double}    {3×1 double}    {3×1 cell}    {3×1 double}

检查各个条目。请注意，C{1} 和 C{2} 为元胞数组。C{5} 的数据类型为 uint32，因此 C{5} 的前两个元素为 32 位无符号整数的最大值或 intmax('uint32')。

celldisp(C)

 
C{1}{1} =
 
09/12/2005
 
 
C{1}{2} =
 
10/12/2005
 
 
C{1}{3} =
 
11/12/2005
 
 
C{2}{1} =
 
Level1
 
 
C{2}{2} =
 
Level2
 
 
C{2}{3} =
 
Level3
 
 
C{3} =
 
   12.3400
   23.5400
   34.9000

 
 
C{4} =
 
   45
   60
   12

 
 
C{5} =
 
   4294967295
   4294967295
       200000

 
 
C{6} =
 
   Inf
  -Inf
    10

 
 
C{7} =
 
       NaN
    0.0010
  100.0000

 
 
C{8}{1} =
 
Yes
 
 
C{8}{2} =
 
No
 
 
C{8}{3} =
 
No
 
 
C{9} =
 
   5.1000 + 3.0000i
   2.2000 - 0.5000i
   3.1000 + 0.1000i

 

从前一示例的第二列数据的每个字段中删除字面文本 'Level'。下面显示文件的预览。

打开文件，并匹配 formatSpec 输入中的字面文本。

filename = 'scan1.dat';
fileID = fopen(filename);
C = textscan(fileID,'%s Level%d %f32 %d8 %u %f %f %s %f');
fclose(fileID);
C{2}

ans = 3×1 int32 column vector

   1
   2
   3

查看 C 中的第二个元胞的 MATLAB® 数据类型。1-by-9 元胞数组 C 的第二个元胞的数据类型现在为 int32。

disp( class(C{2}) )

int32

将前一示例中文件的第一列读取到元胞数组中，跳过行的其余部分。

filename = 'scan1.dat';
fileID = fopen(filename);
dates = textscan(fileID,'%s %*[^\n]');
fclose(fileID);
dates{1}

ans = 3×1 cell
    {'09/12/2005'}
    {'10/12/2005'}
    {'11/12/2005'}

textscan 返回一个日期元胞数组。

加载文件 data.csv 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意该文件包含逗号分隔的数据以及空值。

读取该文件，将空元胞转换为 -Inf。

filename = 'data.csv';
fileID = fopen(filename);
C = textscan(fileID,'%f %f %f %f %u8 %f',...
'Delimiter',',','EmptyValue',-Inf);
fclose(fileID);
column4 = C{4}, column5 = C{5}

column4 = 2×1

     4
  -Inf

column5 = 2×1 uint8 column vector

    0
   11

textscan 返回 1-by-6 元胞数组 C。textscan 函数将 C{4} 中的空值转换为 -Inf，其中 C{4} 与浮点格式关联。因为 MATLAB® 将无符号整数 -Inf 表示为 0，所以 textscan 将 C{5} 中的空值转换为 0 而不是 -Inf。

加载文件 data2.csv 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意，该文件包含可以解释为注释和其他项（如 'NA' 或 'na'）的数据，这些数据可能表示空字段。

filename = 'data2.csv';

指定 textscan 应视为注释或空值的输入，并将该数据扫描到 C 中。

fileID = fopen(filename);
C = textscan(fileID,'%s %n %n %n %n','Delimiter',',',...
'TreatAsEmpty',{'NA','na'},'CommentStyle','//');
fclose(fileID);

显示输出。

celldisp(C)

 
C{1}{1} =
 
abc
 
 
C{1}{2} =
 
def
 
 
C{2} =
 
     2
   NaN

 
 
C{3} =
 
   NaN
     5

 
 
C{4} =
 
     3
     6

 
 
C{5} =
 
     4
     7

 

加载文件 data3.csv 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意，该文件包含重复的分隔符。

filename = 'data3.csv';

要将重复的逗号视为单个分隔符，请使用 MultipleDelimsAsOne 参数并将值设置为 1 (true)。

fileID = fopen(filename);
C = textscan(fileID,'%f %f %f %f','Delimiter',',',...
'MultipleDelimsAsOne',1);
fclose(fileID);


celldisp(C)

 
C{1} =
 
     1
     5

 
 
C{2} =
 
     2
     6

 
 
C{3} =
 
     3
     7

 
 
C{4} =
 
     4
     8

 

加载此示例的数据文件 grades.txt 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意，该文件包含重复的分隔符。

filename = 'grades.txt';

使用格式 '%s' 四次读取列标题。

fileID = fopen(filename);
formatSpec = '%s';
N = 4;
C_text = textscan(fileID,formatSpec,N,'Delimiter','|');

读取文件中的数值数据。

C_data0 = textscan(fileID,'%d %f %f %f')

C_data0=1×4 cell array
    {4×1 int32}    {4×1 double}    {4×1 double}    {4×1 double}

CollectOutput 的默认值是 0 (false)，因此 textscan 以一个单独的数组返回每列数值数据。

将文件位置指示符设置为文件的开头。

frewind(fileID);

重新读取文件并将 CollectOutput 设置为 1 (true)，将相同类的连续列收集到一个单独的数组中。您可以使用 repmat 函数指示 %f 转换设定符必须出现三次。当一种格式重复多次时，此方法很有用。

C_text = textscan(fileID,'%s',N,'Delimiter','|');
C_data1 = textscan(fileID,['%d',repmat('%f',[1,3])],'CollectOutput',1)

C_data1=1×2 cell array
    {4×1 int32}    {4×3 double}

测试分数（均为 double）被收集到一个单独的 4×3 数组中。

关闭文件。

fclose(fileID);

读取文本文件的第一列数据和最后一列数据。跳过文本列和整数数据列。

加载文件 names.txt 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意，该文件包含两列带引号的文本，后跟一个整数列，最后一列为浮点数。

filename = 'names.txt';

读取该文件中的第一列数据和最后一列数据。使用转换设定符 %q 读取由双引号 (") 引起来的文本。%*q 跳过引用文本，%*d 跳过整数字段，而 %f 读取浮点数。使用 'Delimiter' 名称-值对组参量指定逗号分隔符。

fileID = fopen(filename,'r');
C = textscan(fileID,'%q %*q %*d %f','Delimiter',',');
fclose(fileID);

显示输出。textscan 返回元胞数组 C，其中删除了文本前后的双引号。

celldisp(C)

 
C{1}{1} =
 
Smith, J.
 
 
C{1}{2} =
 
Bates, G.
 
 
C{1}{3} =
 
Curie, M.
 
 
C{1}{4} =
 
Murray, G.
 
 
C{1}{5} =
 
Brown, K.
 
 
C{2} =
 
   71.1000
   69.3000
   64.1000
  133.0000
   64.9000

 

加载文件 german_dates.txt 并在文本编辑器中预览其内容。屏幕截图如下所示。请注意，第一列值包含德语的日期，第二列和第三列是数值。

filename = 'german_dates.txt';

打开文件。将与文件关联的字符编码方案指定为 fopen 的最后输入。

fileID = fopen(filename,'r','n','ISO-8859-15');

读取文件。使用 %{dd % MMMM yyyy}D 设定符指定文件中日期的格式。使用 DateLocale 名称-值对组参量指定日期的区域设置。

C = textscan(fileID,'%{dd MMMM yyyy}D %f %f',...
    'DateLocale','de_DE','Delimiter',',');
fclose(fileID);

查看 C 中第一个元胞的内容。日期以 MATLAB 使用的语言显示，具体取决于您的系统区域设置。

C{1}

ans = 3×1 datetime
   01 January 2014 
   01 February 2014
   01 March 2014   

使用 sprintf 转换数据中的非默认转义序列。

创建包含换页符 \f 的文本。随后，要使用 textscan 读取文本，请调用 sprintf 显式转换换页符。

lyric = sprintf('Blackbird\fsinging\fin\fthe\fdead\fof\fnight');
C = textscan(lyric,'%s','delimiter',sprintf('\f'));
C{1}

ans = 7×1 cell
    {'Blackbird'}
    {'singing'  }
    {'in'       }
    {'the'      }
    {'dead'     }
    {'of'       }
    {'night'    }

textscan 返回元胞数组 C。

从开头以外的位置恢复扫描。

如果恢复文本扫描，textscan 每次都会从开头读取。要从任何其他位置恢复扫描，请在 textscan 的初始调用中使用双输出参量语法。

例如，创建一个名为 lyric 的字符向量。读取该字符向量的第一个词，然后恢复扫描。

lyric = 'Blackbird singing in the dead of night';
[firstword,pos] = textscan(lyric,'%9c',1);
lastpart = textscan(lyric(pos+1:end),'%s');