最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

writetable

ファイルへのテーブルの書き込み

構文

writetable(T)

writetable(T,filename)

writetable(___,Name,Value)

説明

writetable(T) は、table T をコンマ区切り形式のテキスト ファイルに書き込みます。ファイル名はテーブルのワークスペースの変数名で、拡張子 .txt が追加されます。writetable が入力テーブル名からファイルの名前を作成できない場合、ファイル table.txt に書き込みます。

T の各変数の各列は、出力ファイルの 1 つの列になります。T の変数名は、ファイルの最初の行の列見出しになります。

writetable(T,filename) は、filename で指定された名前と拡張子のファイルに書き込みます。

writetable は、指定された拡張子に基づいてファイル形式を判別します。拡張子は、次のいずれかでなければなりません。

• 区切りテキスト ファイルの場合、.txt、.dat または .csv

• Excel^® スプレッドシート ファイルの場合、.xls、.xlsm または .xlsx

• Excel for Windows^® を備えたシステムでサポートされる Excel スプレッドシート ファイルの場合、.xlsb

writetable(___,Name,Value) は、1 つ以上の Name,Value ペアの引数で指定された追加のオプションを使用して、table をファイルに書き込みます。前述の構文の任意の入力引数を含めることができます。

たとえば、変数名を出力ファイルの列見出しとして書き込むかどうかを指定することができます。

例

テーブルをテキスト ファイルに書き込む

テーブルを作成します。

T = table(['M';'F';'M'],[45 45;41 32;40 34],...
    {'NY';'CA';'MA'},[true;false;false])

T=3×4 table
    Var1      Var2      Var3    Var4 
    ____    ________    ____    _____

     M      45    45    'NY'    true 
     F      41    32    'CA'    false
     M      40    34    'MA'    false

テーブルをコンマ区切り形式のテキスト ファイルに書き込んで、ファイルの内容を表示します。

writetable(T)

writetable は、T.txt という名前のテキスト ファイルを出力します。

type 'T.txt'

Var1,Var2_1,Var2_2,Var3,Var4
M,45,45,NY,1
F,41,32,CA,0
M,40,34,MA,0

writetable は、対応するデータの 2 列上の変数名 Var2 に、一意の接尾辞を追加します。

テーブルをスペース区切り形式のテキスト ファイルに書き込む

テーブルを作成します。

T = table(['M';'F';'M'],[45 45;41 32;40 34],...
    {'NY';'CA';'MA'},[true;false;false])

T=3×4 table
    Var1      Var2      Var3    Var4 
    ____    ________    ____    _____

     M      45    45    'NY'    true 
     F      41    32    'CA'    false
     M      40    34    'MA'    false

テーブルを myData.txt という名前のスペース区切りの形式のテキスト ファイルに書き込んで、ファイルの内容を表示します。

writetable(T,'myData.txt','Delimiter',' ')  
type 'myData.txt'

Var1 Var2_1 Var2_2 Var3 Var4
M 45 45 NY 1
F 41 32 CA 0
M 40 34 MA 0

writetable は、対応するデータの 2 列上の変数名 Var2 に、一意の接尾辞を追加します。

行名を含むテキスト ファイルへのテーブルの書き込み

テーブルを作成します。

LastName = {'Smith';'Johnson';'Williams';'Jones';'Brown'};
Age = [38;43;38;40;49];
Height = [71;69;64;67;64];
Weight = [176;163;131;133;119];
BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80];

T = table(Age,Height,Weight,BloodPressure,...
    'RowNames',LastName)

T=5×4 table
                Age    Height    Weight    BloodPressure
                ___    ______    ______    _____________

    Smith       38       71       176       124     93  
    Johnson     43       69       163       109     77  
    Williams    38       64       131       125     83  
    Jones       40       67       133       117     75  
    Brown       49       64       119       122     80  

テーブル T を myPatientData.dat という名前のコンマ区切り形式のテキスト ファイルに書き込んで、ファイルの内容を表示します。

writetable(T,'myPatientData.dat','WriteRowNames',true)  
type 'myPatientData.dat'

Row,Age,Height,Weight,BloodPressure_1,BloodPressure_2
Smith,38,71,176,124,93
Johnson,43,69,163,109,77
Williams,38,64,131,125,83
Jones,40,67,133,117,75
Brown,49,64,119,122,80

行の名前を含んでいる最初の列には、Row という列見出しが付けられています。これは、T.Properties.DimensionNames プロパティからのテーブルに対する最初の次元の名前です。

外国語の日付をテキスト ファイルに書き込む

テーブル内の英語の日付をドイツ語の日付に変換し、そのテーブルをファイルに書き込みます。

英語の日付を格納する datetime 配列を含むテーブルを作成します。日付に対応する数値データの列ベクトルを作成します。

D = datetime({'01-Jan-2014';'01-Feb-2014';'01-Mar-2014'});
D.Format = 'dd MMMM yyyy';
X1 = [20.2;21.6;20.7];
X2 = [100.5;102.7;99.8];
T = table(D,X1,X2)

T = 

           D             X1      X2  
    ________________    ____    _____

    01 January 2014     20.2    100.5
    01 February 2014    21.6    102.7
    01 March 2014       20.7     99.8

テーブルをテキスト ファイルに書き込みます。名前と値のペアの引数 DateLocale を使用して日付のロケールにドイツ語を指定し、テキスト ファイルの日付を表示します。

writetable(T,'myfile.txt','DateLocale','de_DE');
type myfile.txt

D,X1,X2
01 Januar 2014,20.2,100.5
01 Februar 2014,21.6,102.7
01 März 2014,20.7,99.8

テキスト ファイルに英語以外の言語の文字を書き込む

データに英語以外の文字または非 ASCII 文字が含まれる場合は、必ずファイルが正しく書き込まれるように、エンコード パラメーターを使用します。まず、用意された table をワークスペースに読み込みます。次に、既定のエンコードを使用して table をファイルに書き込みます。最後に、'UTF-8' エンコードを使用して table を書き込み、結果を確認します。

table T を含む Table_Japanese_Characters.mat を読み込みます。table のプレビューを以下に示します。table には日本語の文字を含む 2 つの列があります。

load('Table_Japanese_Characters.mat')

table をファイルに書き込みます。関数 writetable はファイルを書き込むときにシステムの既定のエンコードを使用します。結果はシステム設定によって異なる場合があります。結果のファイルを確認するために、関数 readtable を使用して再度 table をワークスペースに読み込みます。writetable は英語以外の文字を含む列 (1 と 3) の書き込みに失敗しています。

writetable(T,'myTable.txt')
myTable = readtable('myTable.txt')

myTable=9×3 table
      A        B          C   
    _____    ______    _______

    ''     458.98    ''  
    ''     530.14    ''  
    ''      289.4    ''  
    ''      434.81    ''
    ''    186.44    '' 
    ''           0    ''   
    ''      231.29    ''
    ''      311.86    ''
    ''     239.93    ''   

table に英語以外の文字または非 ASCII 文字が含まれる場合は、必ずデータが正しく書き込まれるように、'Encoding' パラメーターを使用しなければなりません。'Encoding' を英語以外の様々な文字および非 ASCII 文字をサポートする 'UTF-8' に設定します。結果のファイルを確認するために、関数 readtable を使用して再度 table をワークスペースに読み込みます。正しいエンコード パラメーターを使うと、関数 writetable によるデータの書き込みは正常に行われます。

writetable(T,'myTable_UTF8.txt','Encoding','UTF-8')
myTable_UTF8 = readtable('myTable_UTF8.txt','Encoding','UTF-8')

myTable_UTF8=9×3 table
       A         B            C     
    _______    ______    ___________

    '南西'     458.98    '冬の嵐'    
    '南東'     530.14    '冬の嵐'    
    '南東'      289.4    '冬の嵐'    
    '西'       434.81    '機器の故障' 
    '中西部'    186.44    '深刻な嵐'  
    '西'            0    '攻撃'      
    '西'       231.29    '機器の故障' 
    '西'       311.86    '機器の故障' 
    '北東'     239.93    '火災'      

引用符付きテキストの CSV ファイルへの書き込み

テーブルを作成します。

T = table(['M';'F';'M'],[45;41;36],...
    {'New York, NY';'San Diego, CA';'Boston, MA'},[true;false;false])

T=3×4 table
    Var1    Var2         Var3          Var4 
    ____    ____    _______________    _____

     M       45     'New York, NY'     true 
     F       41     'San Diego, CA'    false
     M       36     'Boston, MA'       false

myData.csv という名前のコンマ区切り形式のテキスト ファイルにテーブルを書き込んで、ファイルの内容を表示します。名前と値のペア引数 'QuoteStrings' を使用して、3 列目のコンマが区切り記号として扱われることを確実に防ぎます。

writetable(T,'myData.csv','Delimiter',',','QuoteStrings',true)
type 'myData.csv'

Var1,Var2,Var3,Var4
"M",45,"New York, NY",1
"F",41,"San Diego, CA",0
"M",36,"Boston, MA",0

スプレッドシートの特定のシートおよび範囲へのテーブルの書き込み

テーブルを作成します。

T = table(['M';'F';'M'],[45 45;41 32;40 34],...
    {'NY';'CA';'MA'},[true;false;false])

T=3×4 table
    Var1      Var2      Var3    Var4 
    ____    ________    ____    _____

     M      45    45    'NY'    true 
     F      41    32    'CA'    false
     M      40    34    'MA'    false

myData.xls という名前のスプレッドシートにテーブルを書き込みます。コーナーが B2 と F6 になる 5 行 5 列の領域の 2 番目のシートのデータを含めます。

writetable(T,'myData.xls','Sheet',2,'Range','B2:F6')

Excel® は B6 から F6 のスプレッドシートの行を #N/A で埋めます。これは指定された範囲が入力テーブル T のサイズより大きいためです。

入力引数

T — 入力データ

テーブル

入力データ。テーブルとして指定します。

filename — ファイル名

文字ベクトル | string スカラー

ファイル名。文字ベクトルまたは string スカラーとして指定します。特定のフォルダーに書き込むには絶対パス名を指定してください。そうでない場合、writetable は現在のフォルダー内のファイルに書き込みます。filename にファイル拡張子が含まれる場合、writetable は拡張子からファイル形式を判別します。そうでない場合、writetable はコンマ区切りのテキスト ファイルを作成し、拡張子 .txt を追加します。代替方法として、ファイル拡張子を付けずに filename を指定し、'FileType' 名前と値のペアの引数を含めてファイルの種類を示すことができます。

• filename が存在しない場合、writetable がファイルを作成します。

• filename が既存のファイルの名前である場合、writetable はそのファイルを上書きします。

• filename が既存のスプレッドシート ファイルの名前である場合、writetable は指定の位置にテーブルを書き込みますが、その範囲外にある値は一切上書きしません。

例: 'myData.xls' または "myData.xls"

例: 'C:\test\myData.txt'

データ型: char | string

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'WriteVariableNames',false は、変数名が出力ファイルの最初の行として含まれないようにすることを示します。

テキスト ファイルとスプレッドシート ファイル

'FileType' — ファイルの種類

'text' | 'spreadsheet'

ファイルの種類。'FileType' と、'text' または 'spreadsheet' を含む文字ベクトルまたは string から構成されるコンマ区切りのペアとして指定します。

'FileType' 名前と値ペアは、filename 入力引数と一緒に使用しなければなりません。writetable が filename 入力引数の拡張子に基づいてファイルの種類を判定できる場合、名前と値のペアの引数 'FileType' を指定する必要はありません。writetable は、次の拡張子からファイルの種類を判定できます。

• 区切りテキスト ファイルの場合、.txt、.dat または .csv

• Excel スプレッドシート ファイルの場合、.xls、.xlsm または .xlsx

• Excel for Windows を備えたシステムでサポートされる Excel スプレッドシート ファイルの場合、.xlsb

例: writetable(T,'mySpreadsheet','FileType','spreadsheet')

例: writetable(T,'mySpreadsheet','FileType',"spreadsheet")

データ型: char | string

'WriteVariableNames' — 変数名を列見出しとして書き込むためのインジケーター

true (既定値) | false

変数名を列見出しとして書き込むためのインジケーター。'WriteVariableNames' と、true または false のいずれかで構成されるコンマ区切りのペアとして指定します。

インジケーター	動作
true	writetable は、変数名を出力の列見出しとして含めます。これは既定の動作です。 'WriteVariableNames' と 'WriteRowNames' の両方の論理インジケーターが true の場合、writetable は出力の最初の列の列見出しとして、T.Properties.DimensionNames プロパティから最初の次元の名前を使用します。
false	writetable は出力に変数名を含めません。

'WriteRowNames' — 最初の列の行名を書き込むためのインジケーター

false (既定値) | true

最初の列の行名を書き込むためのインジケーター。'WriteRowNames' と、false または true のいずれかで構成されるコンマ区切りのペアとして指定します。

インジケーター	動作
false	writetable は出力に T からの行名を含めません。これは既定の動作です。
true	writetable は、出力の最初の列として T からの行名を含めます。 'WriteVariableNames' と 'WriteRowNames' の両方の論理インジケーターが true の場合、writetable は出力の最初の列の列見出しとして、T.Properties.DimensionNames プロパティから最初の次元の名前を使用します。

'DateLocale' — 日付を書き込むためのロケール

文字ベクトル | string スカラー

日付を書き込むためのロケール。'DateLocale' と、文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。datetime 値をファイルに書き込む場合、DateLocale を使用して writetable が月と曜日の名前および略語を書き込むロケールを指定します。xx_YY の形式の文字ベクトルまたは string。xx は ISO 639-1 で定義された小文字 2 文字の言語コードで、YY は ISO 3166-1 alpha-2 で定義された大文字の国コードです。ロケールの一般的な値の一覧については、関数 datetime の Locale の名前と値のペア引数を参照してください。

日付が Excel 形式の日付として記述できる場合、writetable は常に 'DateLocale' パラメーターの値を無視します。詳細については、アルゴリズムを参照してください。

例: 'DateLocale','ja_JP' または 'DateLocale',"ja_JP"

データ型: char | string

テキスト ファイルのみ

'Delimiter' — フィールドの区切り記号

文字ベクトル | string スカラー

フィールドの区切り記号。'Delimiter' と、次の指定子のいずれかを含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

指定子	フィールドの区切り記号
',' 'comma'	コンマ。これは既定の動作です。
' ' 'space'	スペース
'\t' 'tab'	タブ
';' 'semi'	セミコロン
'|' 'bar'	縦棒

'Delimiter' 名前と値のペアは区切り付きテキスト ファイルに対してのみ使用できます。

例: 'Delimiter','space' または 'Delimiter',"space"

データ型: char | string

'QuoteStrings' — 引用符付きテキスト書き込みのインジケーター

false (既定値) | true

引用符付きテキスト書き込みのインジケーター。'QuoteStrings' と、false または true のいずれかで構成されるコンマ区切りのペアとして指定します。'QuoteStrings' が true の場合、writetable はテキストを二重引用符で囲み、テキストの一部として表示される二重引用符をすべて 2 つの二重引用符に置き換えます。例については、引用符付きテキストの CSV ファイルへの書き込みを参照してください。

'QuoteStrings' の名前と値のペアは区切り付きテキスト ファイルでのみ使用できます。

'Encoding' — 文字エンコード スキーム

'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

ファイルに関連付けられた文字エンコード スキーム。'Encoding' と 'system' で構成されるコンマ区切りのペア、または次の表に示す値のいずれかのような標準の文字エンコード スキーム名として指定します。エンコードを指定しない場合、またはエンコードを 'system' として指定した場合は、関数 writetable はシステムの既定のエンコードを使用してファイルを書き込みます。

'Big5'	'ISO-8859-1'	'windows-847'
'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'

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

データ型: char | string

スプレッドシート ファイルのみ

'Sheet' — 書き込み先のワークシート

文字ベクトル | string スカラー | 正の整数

書き込み先のワークシート。'Sheet' と、ワークシート名またはワークシート インデックスを示す正の整数を含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。ワークシート名にコロン (:) を含めることはできません。スプレッドシート ファイルのシートの名前を決めるには、[status,sheets] = xlsfinfo(filename) を使用します。

シートが存在しない場合は、writetable がワークシート コレクションの最後に新しいシートを追加します。シートがワークシート数より大きいインデックスの場合は、ワークブック内のワークシートの数がシート インデックスと同じになるまで、writetable は空のシートを追加します。いずれの場合でも、writetable は新しいワークシートが追加されたことを示す警告を表示します。

'Sheet' 名前と値のペアはスプレッドシート ファイルでのみ使用できます。

例: 'Sheet',2

例: 'Sheet', 'MySheetName'

データ型: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

'Range' — 書き込み対象のワークシートの四角形部分

文字ベクトル | string スカラー

書き込み対象のワークシートの四角形部分。'Range' と、次のいずれかの形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

Range の値の形式	説明
'Corner1'	Corner1 は、書き込む領域の最初のセルを指定します。writetable は、テーブル T の書き込みをこのセルから開始します。 例: 'Range','D2'
'Corner1:Corner2'	Corner1 と Corner2 は、書き込む領域を定義する 1 組の対角です。たとえば、'D2:H4' は、ワークシート上の 2 つの角 D2 と H4 の間にある 3 行 5 列の四角形領域を表します。'Range' 名前と値のペアの引数では大文字小文字は区別されず、Excel A1 参照スタイル (Excel ヘルプを参照) が使用されます。 例: 'Range','D2:H4' 指定範囲が入力テーブル T のサイズより小さい場合、writetable は入力テーブルのうち範囲に収まるサブセットのみを書き込みます。 指定範囲が入力テーブル T のサイズより大きい場合、writetable は残りの領域をそのままにします。

'Range' 名前と値のペアは、Excel ファイルと一緒にのみ使用できます。

例: 'Range', 'A1:F10'

例: 'Range', "A1:F10"

データ型: char | string

'UseExcel' — Microsoft Excel for Windows のインスタンスを起動するためのフラグ

true | false

スプレッドシート データを書き込む際に、Windows 版 Microsoft^® Excel のインスタンスを起動するためのフラグ。'UseExcel' と、true または false のいずれかで構成されるコンマ区切りのペアとして指定します。

Windows プラットフォームでスプレッドシート ファイルに書き込む際に、Microsoft Excel のインスタンスが起動しないようにするには、'UseExcel' パラメーターを false に設定します。

'UseExcel' パラメーターは、次の値のいずれかに設定できます。

• true — ファイルを書き込む際に、関数 writetable によって Microsoft Excel のインスタンスが起動します。これは、Excel がインストールされている Windows システムの既定の設定です。

• false — ファイルを書き込んでも、関数 writetable は Microsoft Excel のインスタンスを起動しません。Excel のない Windows、Mac、および Linux^® では、既定値は false です。このモードで動作している writetable では、サポートするファイル形式および式やマクロなどの対話型機能が異なります。

UseExcel	true	false
サポートされているファイル形式	.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods	.xls, .xlsx, .xlsm, .xltx, .xltm
式やマクロなどの対話型機能のサポート	あり	なし

制限

• Linux プラットフォームと Mac プラットフォームでは、関数 xlsread またはインポート ツールは、関数 writetable で書き込まれたスプレッドシートを開くことができません。

アルゴリズム

• Excel は Inf 値を 65535 に変換します。MATLAB^® は NaN、NaT、categorical 値 <undefined> および string 値 <missing> を空のセルに変換します。

• Excel ファイルの場合、writetable は datetime 配列を含む table 変数を Excel の日付として書き込みます。table に含まれる datetime 配列に 1900 年または 1904 年よりも前の年がある場合、writetable は変数をテキストとして書き込みます。Excel の日付の詳細については、https://support.microsoft.com/en-us/kb/214330 を参照してください。

• 場合によっては、関数 writetable で作成したファイルが T を正確に表していないことがあります。これは、readtable を使用してそのファイルを読み取ったときに判明します。結果の table の形式または内容が元の table とは異なることがあります。table を保存し、後で元の table と厳密に一致する同一のデータおよび構成を復元する必要がある場合は、MAT ファイルとして保存します。次の場合に、writetable が書き込む table は厳密に一致しません。

  • テキスト ファイルを書き込む場合、writetable は、long g 形式を使用して数値変数を出力し、カテゴリカル変数や文字変数は、引用符で囲まれない文字として出力します。

  • 複数の列がある変数の場合、writetable は列見出しとして使用する変数名に一意の識別子を追加します。

  • 3 つ以上の次元が存在する出力変数の場合、writetable はこれらの変数を、後続の次元がたたまれた 2 次元として出力します。たとえば、writetable は 4 x 3 x 2 の変数を、4 行 6 列のサイズとして出力します。

  • cell データ型の変数の場合、writetable は各セルの内容を複数フィールド内の単一行として出力します。内容が数値、論理値、文字またはカテゴリカル以外の場合、writetable は単一の空フィールドを出力します。

参考

readtable | table

R2013b で導入