主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

writetable

ファesc escルへの表の書き込み

説明

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

テキストファルおよびスプレッドシトファルの場合,Tの各変数の各列が出力ファXMLノ。XMLファ电子邮箱ルの場合,Tの各列が出力ファ▪▪ルの1▪▪のXMLノ▪▪ドになります。Tの変数の名前が出力XMLファルの要素ノドの名前になります。

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

writetableは,指定された拡張子に基づいてファ。拡張子は,次のいずれかでなければなりません。

  • 区切りテキストファ电子邮箱ルの場合,. txt.datまたは. csv

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

  • Excel for Windows®を備えたシステムでサポ,トされるExcelスプレッドシ,トファ,.xlsb

  • 拡張マ,クアップ言語(xml)の場合,. xml

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

たとえば,変数名を出力ファ。

すべて折りたたむ

表を作成します。

T = table(表“米”“F”“米”],[45 45;41 32;40 34],...“纽约”“CA”“马”},真的,假的,假)
T =3×4表Var1 Var2 Var3 Var4  ____ ________ ______ _____ 45米45{“纽约”}真F 41 32{“CA”}假40 M 34{‘马’}假

表をコンマ区切り形式のテキストファaapl . exeルに書き込んで,ファaapl . exeルの内容を表示します。

writetable (T)

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

类型“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(表“米”“F”“米”],[45 45;41 32;40 34],...“纽约”“CA”“马”},真的,假的,假)
T =3×4表Var1 Var2 Var3 Var4  ____ ________ ______ _____ 45米45{“纽约”}真F 41 32{“CA”}假40 M 34{‘马’}假

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

writetable (T)“myData.txt”“分隔符”' ')类型“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に,一意の接尾辞を追加します。

表を作成します。

姓氏= {“史密斯”“约翰逊””威廉姆斯“琼斯”“棕色”};年龄= [38;43;38;40;49];身高= [71;69;64;67;64];Weight = [176;163;131;133;119];血压= [124 93;109 77;125 83;117 75;122 80);T =表(年龄,身高,体重,血压,...“RowNames”、LastName)
T =5×4表年龄身高体重血压_________ ______ _____________史密斯38 71 176 124 93约翰逊43 69 163 109 77威廉姆斯38 64 131 125 83琼斯40 67 133 117 75布朗49 64 119 122 80

表格TmyPatientData.datという名前のコンマ区切り形式のテキストファaapl . exeルに書き込んで,ファaapl . exeルの内容を表示します。

writetable (T)“myPatientData.dat”“WriteRowNames”,真正的)类型“myPatientData.dat”
罗,年龄,身高,体重,血压_1,血压_2史密斯,38,71,176,124,93约翰逊,43,69,163,109,77威廉姆斯,38,64,131,125,83琼斯,40,67,133,117,75布朗,49,64,119,122,80

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

表内の英語の日付をドesc esc語の日付に変換し,表そのesc escルに書き込みます。

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

D =日期时间({' 01 - 1月- 2014“01 - 2月- 2014”' 01 - 3月- 2014});D.Format ='dd MMMM yyyy';X1 = [20.2;21.6;20.7];X2 = [100.5;102.7;99.8];T =表(D,X1,X2)
T = D X1 X2 ________________ _________ 2014年1月01日20.2 100.5 2014年2月01日21.6 102.7 2014年3月01日20.7 99.8

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

writetable (T)“myfile.txt”“DateLocale”“de_DE”);类型myfile.txt
D,X1,X2 01 2014年1月,20.2,100.5 01 2014年2月,21.6,102.7 01 März 2014,20.7,99.8

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

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

负载(“Table_Japanese_Characters.mat”

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

writetable (T)“myTable.txt”myTable =可读表(“myTable.txt”
myTable =9×3表A B C  _____ ______ _______ '' 458.98”、“530.14”、“289.4”“434.81”“186.44”“0”“231.29”“311.86”“239.93”

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

writetable (T)“myTable_UTF8.txt”“编码”“utf - 8”myTable_UTF8 = readtable(“myTable_UTF8.txt”“编码”“utf - 8”
myTable_UTF8 =9×3表A B C  _______ ______ ___________ ' 南西“458.98”冬の嵐“南東“530.14”冬の嵐“南東“289.4”冬の嵐‘西“434.81”機器の故障“中西部“186.44”深刻な嵐‘西' 0 '攻撃”“西“231.29”機器の故障”“西“311.86”機器の故障“北東‘239.93’火災”

表を作成します。

T = table(表“米”“F”“米”]、[45、41、36),...“纽约,纽约”“加州圣地亚哥”“波士顿”},真的,假的,假)
T =3×4表Var1 Var2 Var3 Var4  ____ ____ _________________ _____ 米45{“纽约,纽约”}真的F 41{“圣地亚哥CA”}假米36{“波士顿”}假

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

writetable (T)“myData.csv”“分隔符””、““QuoteStrings”,真正的)类型“myData.csv”
Var1、Var2 Var3, Var4“M”,45岁的“纽约,纽约”1“F”,41岁的圣地亚哥,CA, 0“M”,36岁的“波士顿”,0

表を作成します。

T = table(表“米”“F”“米”],[45 45;41 32;40 34],...“纽约”“CA”“马”},真的,假的,假)
T =3×4表Var1 Var2 Var3 Var4  ____ ________ ______ _____ 45米45{“纽约”}真F 41 32{“CA”}假40 M 34{‘马’}假

myData.xlsという名前のスプレッドシ,トに表を書き込みます。最初のシ,トのB2F6を角とする5行5列の領域にデタを入れます。ワクシトに対応するンデックスを指定して,書き込み先のワクシトを変更できます。

writetable (T)“myData.xls”“表”, 1“范围”“B2: F6”

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

スペースと非ASCII文字を含む,任意の文字を使用した変数名が含まれる表形式データを書き込むことができます。任意の変数名を含む表を作成し,表をテキストファ表ルに書き込みます。次に,元の変数名を保持しながら表形式デ,タを読み戻します。

任意の変数名をも3の変数を含む表を作成します。1番目と3番目の変数名には,スペスや非ASCII文字が含まれています。

姓氏= {“桑切斯”“约翰逊”“李”“Diaz”“棕色”};年龄= [38;43;38;40;49];吸烟者=逻辑([1;0;1;0;1]);varNames = {“姓”“年龄”“吸烟者(1或0)”};T = table(姓氏,年龄,吸烟者,“VariableNames”varNames)
T =5×3表姓名年龄吸烟者(1或0 ) ___________ ___ _______________ {' 桑切斯的38}真{“约翰逊”}43假{‘李’}38真{“Diaz”}40假{“棕色”}49真的

デタをファル“sampletable.txt”に書き込みます。

writetable (T)“sampletable.txt”

readtableを使用して,表形式デ,タを読み戻します。既定で,MATLAB®はスペースおよび非ASCII文字が含まれる変数名を,有効なMATLAB®識別子に変換します。たとえば,matlab®は変数名“姓”“姓”“吸烟者(1或0)”“Smoker_1or0_”に変換します。変数名を保持しながら表形式デ,タを読み取るには,“VariableNamingRule”パラメ,タ,を保存に設定します。

T_preserve = readtable(“sampletable.txt”“VariableNamingRule”“保存”
T_preserve =5×3表姓名年龄吸烟者(1或0 ) ___________ ___ _______________ {' 桑切斯的}38 43 0 1{“约翰逊”}{‘李’}38 1{“Diaz”}40 0{“棕色”}49 1

既存デタをもtableの末尾に新しい行としてデタを追加します。

表を作成します。

昆虫种类= {“帝王蝶”“七点飘”“兰花螳螂”...“美国大黄蜂”“蓝色蜻蜓”};昆虫订单= {鳞翅类的“鞘翅目”“螳螂目”膜翅目昆虫的“蜻蜓目”};昆虫家族= {“Nymphalidae”“瓢虫科”“Hymenopodidae”...蜜蜂科的“蜻蜓科”};捕食昆虫= logical([0;1;1;0;1]);T = table(昆虫种类,昆虫目,昆虫科,捕食昆虫)
T =5×4表InsectSpecies InsectOrder InsectFamily PredatoryInsect  _________________________ _______________ _________________ _______________ {' 帝王蝶”}{鳞翅目的}{‘Nymphalidae}假{“七点飘”}{的鞘翅目}{}“瓢虫科”真正的{“兰花螳螂”}{“螳螂目”}{‘Hymenopodidae}真的{“美国大黄蜂”}{膜翅目昆虫的}{}“蜜蜂科”假{“蓝色气宇轩昂的男子蜻蜓”}{“蜻蜓目”}{}“蜻蜓科”真的

表TをInsectCollection.txtというテキストファ@ @ルに書き込みます。

writetable (T)“InsectCollection.txt”“WriteRowNames”,真正的)

表の形式で新しいデ,タを作成して既存表に追加します。

newInsect = table({“Red-banded叶蝉的}, {“半翅类”}, {“叶蝉科”}、逻辑([0]))
newInsect =1×4表Var1 Var2 Var3 Var4  _________________________ _____________ ________________ _____ {' Red-banded叶蝉的}{“半翅类”}{叶蝉科的}假

名前と値のペアの引数“写模式”,“添加”を使用して,newInsectInsectCollection.txtに追加します。

writetable (newInsect“InsectCollection.txt”“写模式”“添加”...“WriteVariableNames”假的,“WriteRowNames”,真正的)

表をワ,クスペ,スに読み戻します。

readtable (“InsectCollection.txt”
ans =6×4表InsectSpecies InsectOrder InsectFamily PredatoryInsect  _________________________ _______________ _________________ _______________ {' 帝王蝶”}{鳞翅目的}{‘Nymphalidae} 0{“七点飘”}{的鞘翅目}{瓢虫科的}1{“兰花螳螂”}{“螳螂目”}{‘Hymenopodidae} 1{“美国大黄蜂”}{膜翅目昆虫的}{}“蜜蜂科”0{“蓝色气宇轩昂的男子蜻蜓”}{“蜻蜓目”}{“蜻蜓科”}1{“Red-banded叶蝉的}{“半翅类”}{叶蝉科的}0

スプレッドシトファルの末尾にデタを追加する際に,ファルの既存の列幅を保持します。

テキストデータをもつワークスペース変数を作成し,次に変数のコンテナーとして表を作成します。

状态= {“还有”“加州”明尼苏达州的“维吉尼亚”};stateFlower = {“落后于杨梅”“金罂粟”《白粉女郎的拖鞋》“开花山茱萸”};stateBird = {“吃教的山雀”“加州山谷鹌鹑”“共同的笨蛋”“红衣主教”};data = table(state,stateFlower, statbird);

states_funfacts.xlsxという名前のスプレッドシトファルに表を書き込みます。

writetable(数据、“state_funfacts.xlsx”

別のテキストデ,タの表を作成します。

T = table({马里兰州的“纽约”}, {黑眼苏珊的“玫瑰”}, {“巴尔的摩金莺”“东方蓝知更鸟”});

その表を既存のスプレッドシトファルに追加します。スプレッドシ,トの既存の列幅を保持するには,“AutoFitWidth”として指定します。

writetable (t)“state_funfacts.xlsx”“写模式”“添加”“AutoFitWidth”、假);

“AutoFitWidth”ではなく真正的として指定すると,writetableは元の列幅を保持せずに,書き込まれるデ,タに合わせてスプレッドシ,トの列幅を調整します。

既存のスプレッドシトファル内の行をスプレッドシトのセルの書式設定を保持せずに編集します。

スプレッドシトファルstudent_grades.xlsxには書式設定されたセルが含まれています。すべてのセルには色の塗りつぶしと境界線があり、ヘッダー セルには太字のフォントがあります。

テキストデ,タと数値デ,タをも,表を作成します。

学生= {“玛丽”“约翰。”};Grade = [95;87];t = table(学生,年级)
t =2×2表学生成绩  ________ _____ {' 玛丽87}95{“约翰”}

既存のスプレッドシトファルを入力デタの表で更新します。スプレッドシトファルの既存のセルの書式設定を無視するには“PreserveFormat”として指定します。これを行うと,student_grades.xlsxは次のように変更されます。

writetable (t,‘student_grades.xlsx’,‘PreserveFormat’,假);

既存のスプレッドシトファルにデタを書き込む際に“PreserveFormat”ではなく真正的として指定すると,writetableはスプレッドシ,トの既存のセルの書式設定を保持します。

writetable (t,‘student_grades.xlsx’,‘PreserveFormat’,真的);

デタの表を作成し,それをXMLファルに書き込みます。追加の名前と値の引数を指定して,writetableが表のデタをXMLファルに書き込む方法をカスタマズします。

デ,タの表を作成します。

昆虫种类= {“帝王蝶”“七点飘”“兰花螳螂”...“美国大黄蜂”“蓝色蜻蜓”};昆虫订单= {鳞翅类的“鞘翅目”“螳螂目”膜翅目昆虫的“蜻蜓目”};昆虫家族= {“Nymphalidae”“瓢虫科”“Hymenopodidae”...蜜蜂科的“蜻蜓科”};捕食昆虫= logical([0;1;1;0;1]);T = table(昆虫目,昆虫科,捕食昆虫);T.Properties.RowNames =昆虫物种;头(T, 5)
ans =5×3表昆虫目昆虫科捕食昆虫_______________ _________________ _______________帝王蝶{‘鳞翅目’}{‘蛱蝶科’}伪七斑瓢虫{‘鞘翅目’}{‘尾翼科’}真兰螳螂{‘螳螂’}{‘膜足科’}真美洲大黄蜂{‘膜翅目’}{‘蚜虫科’}伪蓝斑蜻蜓{‘蜻蜓’}{‘唇蛱蝶科’}真

表格TInsectCollection.xmlという名前のXMLファescルに書き込みます。“WriteRowNames”真正的として指定して,表の行の名前を書き込みます。行名が要素ノドに属するフィルドとして出力XMLファルに表示されます。

“RowNodeName”の値として“虫”を指定して,xmlファズします。

writetable (T)“InsectCollection.xml”“WriteRowNames”假的,“RowNodeName”“虫”

ファereplicationルInsectCollection.xmlの内容を表示します。

类型InsectCollection.xml
<?xml version="1.0" encoding="UTF-8"?> <表> <昆虫> <昆虫目>鳞翅目 <昆虫科>蛱蝶科  <昆虫> <昆虫目>鞘翅目 <昆虫科>Coccinellidae <捕食昆虫>true  <昆虫> <昆虫目> mantoia  <昆虫科>膜足科 <捕食昆虫>true  <昆虫> <昆虫目>膜翅目Apidae < predator Insect>false   Odonata Libellulidae < predator Insect>true  

WriteRowNames真正的として指定しない場合,writetableはファesc escルへの表の行名の書き込みをスキップします。

入力引数

すべて折りたたむ

入力デ,タ。表格として指定します。

ファ@ @ル名。文字ベクトルまたは字符串スカラ,として指定します。

書き込み先の場所によって,文件名は次のいずれかの形式にできます。

場所

形式

現在のフォルダ

現在のフォルダに書き込むには,ファルの名前を文件名に指定します。

例:“myTextFile.csv”

その他のフォルダ

現在のフォルダ,とは異なるフォルダ,に書き込むには,絶対パス名または相対パス名を文件名に指定します。

例:“C: \ myFolder \ myTextFile.csv”

例:“myFolder \ myExcelFile.xlsx”

リモ,トの場所

リモ,トの場所に書き込むには,文件名に次の形式の统一资源定位符(URL)として指定されたファイルの絶対パスを含めなければなりません。

scheme_name: / /path_to_file/my_file.ext

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

リモ,トの場所 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasbwasbs
HDFS™ hdfs

詳細にいては,リモ,トデ,タの操作を参照してください。

例:s3: / / bucketname / path_to_file / my_file.xlsx '

  • 文件名にファaapl . exeル拡張子が含まれる場合,書き込み関数は拡張子からファaapl . exeル形式を判別します。そうでない場合,書き込み関数はコンマ区切りのテキストファaaplルを作成し,拡張子. txtを追加します。代替方法として,ファ文件名を指定し,“文件类型”名前と値のペアの引数を含めてファ@ @ルの種類を示すことができます。

  • 文件名が存在しない場合,書き込み関数がファ。

  • 文件名が既存のテキストファaapl . exeルの名前である場合,書き込み関数はそのファaapl . exeルを上書きします。

  • 文件名が既存のスプレッドシートファイルの名前である場合,書き込み関数はそのデータを指定した場所に書き込みますが,入力データの範囲外にあるいずれの値も上書きしません。

デ,タ型:字符|字符串

名前と値のペアの引数

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

例:“WriteVariableNames”,假的は,変数名が出力ファ。
サポトされるすべてのファルの種類

すべて折りたたむ

行名を書き込むかどうかのンジケタ。“WriteRowNames”または真正的のいずれかで構成されるコンマ区切りのペアとして指定します。

ンジケタ

動作

writetableは出力にTからの行名を含めません。これは既定の動作です。

真正的

テキストファルおよびスプレッドシトファルの場合,writetableは出力の最初の列としてTからの行名を含めます。

“WriteVariableNames”“WriteRowNames”の両方の論理ンジケタが真正的の場合,writetableは出力の最初の列の列見出しとして,T.Properties.DimensionNamesプロパティから最初の次元の名前を使用します。

XMLファ电子邮箱ルの場合,writetableは入力表の行名を各行ノ,ドの最初の属性ノ,ドとして書き込み,T.Properties.DimensionNamesプロパティの最初の次元名を属性ノ,ドの名前として使用します。

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

日付がExcel形式の日付として記述できる場合,書き込み関数は常に“DateLocale”パラメ,タ,の値を無視します。

例:“DateLocale”、“ja_JP”

デ,タ型:字符|字符串

ファ@ @ルの種類。“文件类型”と,“文本”“表格”,または“xml”を含む文字ベクトルまたは字符串から構成されるコンマ区切りのペアとして指定します。

“文件类型”名前と値ペアは,文件名入力引数と一緒に使用しなければなりません。文件名入力引数に標準のファ电子邮箱ル拡張子が含まれている場合,“文件类型”の名前と値のペアの引数を指定する必要はありません。次の標準のファesc escル拡張子は,書き込み関数で認識されます。

  • 区切りテキストファ电子邮箱ルの場合,. txt.datまたは. csv

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

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

  • XMLファ电子邮箱ルの場合,. xml

例:“文件类型”、“表格”

デ,タ型:字符|字符串

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

すべて折りたたむ

変数名を列見出しとして書き込むためのンジケタ。“WriteVariableNames”と,真正的またはのいずれかで構成されるコンマ区切りのペアとして指定します。

ンジケタ

動作

真正的

書き込み関数は,変数名を出力の列見出しとして含めます。これは既定の動作です。

書き込み関数は出力に変数名を含めません。

書き込みモ,ド。“写模式”と,文字ベクトルまたは字符串スカラ,から構成されるコンマ区切りのペアとして指定します。ファ@ @ルの種類に基づいて,書き込みモ@ @ドを選択します。

ファ@ @ルの種類

書き込みモ,ド

テキストファ@ @ル

  • “覆盖”(既定の設定)—ファ安大安大市ルを上書きします。

  • “添加”—デタをファルに追加します。

指定したファ@ @ルが存在しない場合,書き込み関数は新しいファ@ @ルを作成してデ@ @タを書き込みます。

スプレッドシトファル

  • “原地”(既定の設定)-入力デタにより占有された範囲のみを更新します。書き込み関数は入力デ,タにより占有された範囲外のデ,タは一切変更しません。

    • シ,トを指定しない場合,書き込み関数は最初のシ,トに書き込みます。

  • “overwritesheet”—指定されたシ,トをクリアし,クリアしたシ,トに入力デ,タを書き込みます。

    • シ,トを指定しない場合,書き込み関数は最初のシ,トをクリアし,それに入力デ,タを書き込みます。

  • “添加”—書き込み関数は指定されたシトの占有範囲の末尾に入力デタを追加します。

    • シ,トを指定しない場合,書き込み関数は最初のシ,トの占有範囲の末尾に入力デ,タを追加します。

  • “replacefile”—他のすべてのシトをファルから削除し,指定されたシトをクリアして入力デタを書き込みます。

    • シートを指定しない場合,書き込み関数は他のすべてのシートをファイルから削除し,最初のシートをクリアして入力データを書き込みます。

    • 指定したファイルが存在しない場合,書き込み関数は新しいファイルを作成して最初のシートに入力データを書き込みます。

  • WriteVariableNames真正的である場合,書き込み関数は書き込みモ,ド“添加”をサポ,トしません。

  • スプレッドシトファルの場合,次となります。

    • 書き込みモ,ドが“添加”である場合,書き込み関数は范围パラメ,タ,をサポ,トしません。

    • 指定したファesc escルが存在しない場合,書き込み関数は“replacefile”と同じアクションを実行します。

例:“写模式”,“添加”

デ,タ型:字符|字符串

テキストとXMLのみ

すべて折りたたむ

ファルに関連付けられた文字エンコドスキム。“编码”“系统”で構成されるコンマ区切りのペア,または標準の文字エンコ,ドスキ,ム名として指定します。エンコドを何も指定しない場合,書き込み関数はutf-8を使用してファルに書き込みます。

例:“编码”,“utf - 8”は,utf-8をエンコ,ドとして使用します。

デ,タ型:字符|字符串

テキストファ@ @ルのみ

すべて折りたたむ

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

指定子

フィ,ルドの区切り記号

”、“

“逗号”

コンマ。これは既定の動作です。

' '

“空间”

スペス

' \ t '

“标签”

タブ

“;”

“半”

セミコロン

“|”

“酒吧”

縦棒

“分隔符”名前と値のペアは区切り付きテキストファ@ @ルに対してのみ使用できます。

例:“分隔符”、“空间”

デ,タ型:字符|字符串

引用符付きテキスト書き込みのンジケタ。“QuoteStrings”と,または真正的のいずれかで構成されるコンマ区切りのペアとして指定します。“QuoteStrings”真正的の場合,書き込み関数はテキストを二重引用符で囲み,テキストの一部として表示される二重引用符をすべて2つの二重引用符に置き換えます。

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

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

すべて折りたたむ

書き込み先のワ,クシ,ト。“表”と,ワークシート名またはワークシートインデックスを示す正の整数を含む文字ベクトルまたは字符串スカラーで構成されるコンマ区切りのペアとして指定します。ワ、クシ、ト名にコロン()を含めることはできません。スプレッドシトファルのシートの名前を調べるには、Sheets = sheetnames(文件名)を使用します。詳細にいては,sheetnamesを参照してください。

書き込み先のワ、クシ、トを、名前または、ンデックスで指定します。

  • 名前——指定したシート名がファイルに存在しない場合,書き込み関数がワークシートコレクションの最後に新しいシートを追加します。

  • インデックス——指定したシートインデックスがワークシート数より大きい場合,書き込み関数が,ワークブック内のワークシートの数がシートインデックスと等しくなるまで空のシートを追加します。書き込み関数は新しいワ,クシ,トが追加されたことを示す警告も生成します。

“表”名前と値のペアはスプレッドシトファルでのみ使用できます。

例:“表”2

例:“表”“MySheetName”

デ,タ型:字符|字符串|||int8|int16|int32|int64|uint8|uint16|uint32|uint64

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

范围の値の形式 説明
Corner1

Corner1は,書き込む領域の最初のセルを指定します。書き込み関数はこのセルからデ,タを書き込みます。

例:“范围”、“D2”

Corner1: Corner2

Corner1Corner2は,書き込む領域を定義する1組の対角です。たとえば,“D2: H4”は,ワ,クシ,ト上の2の角D2H4の間にある3行5列の四角形領域を表します。“范围”名前と値のペアの引数では大文字小文字は区別されず,Excel A1参照スタイル(Excelヘルプを参照)が使用されます。

例:“范围”、“D2: H4

  • 指定範囲が入力データのサイズより小さい場合,書き込み関数は入力データのうち範囲に収まるサブセットのみを書き込みます。

  • 指定範囲が入力デタのサズより大きい場合,書き込み関数は残りの領域をそのままにします。

“范围”名前と値のペアは,Excelファ,Excelルと一緒にのみ使用できます。

例:“范围”A1: F10的

デ,タ型:字符|字符串

スプレッドシ,トデ,タを書き込むときに,Windows版微软®Excelの@ @ンスタンスを起動するためのフラグ。“UseExcel”と,真正的またはのいずれかで構成されるコンマ区切りのペアとして指定します。

“UseExcel”パラメ,タ,は,次の値のいずれかに設定できます。

  • 真正的——書き込み関数はファイルを書き込むときにMicrosoft Excelのインスタンスを起動します。

  • ——書き込み関数はファイルを書き込むときにMicrosoft Excelのインスタンスを起動しません。このモードで動作している書き込み機能では,サポートするファイル形式および式やマクロなどの対話型機能が異なります。

UseExcel

真正的

サポトされているファル形式

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls, .xlsx, .xlsm, .xltx, .xltm

式やマクロなどの対話型機能のサポ,ト

あり

なし

Windowsプラットフォ,ムでスプレッドシ,トファ,ルに書き込むときに,Microsoft Excelの电子邮箱ンスタンスを起動するには,“UseExcel”パラメ,タ,を真正的に設定します。

列幅の自動調整。真正的またはとして指定します。0の値またはを指定すると,writetableはセルのデ,タに合わせる列幅の自動調整を行いません。

例:“AutoFitWidth”0

既存スプレッドシ,トのセルの書式設定の保持。真正的またはとして指定します。を指定すると,writetableはスプレッドシ,トのセルの書式設定を保持しません。書式設定には,フォント,セルの境界線,色付きのセルなどの要素が含まれます

datetimeデ、タをスプレッドシ、トファ、ルに書き込む場合、既存のセルの書式設定を保持するには、“PreserveFormat”“UseExcel”の両方の名前と値のペアを真正的に設定しなければなりません。datetimeデタをファルに書き込む際に“UseExcel”に,“PreserveFormat”真正的に設定されていると,writetableはファ@ @ルの既存のセルの書式設定を保持しません。

例:“PreserveFormat”

XMLファescルのみ

すべて折りたたむ

属性接尾辞。“AttributeSuffix”と,出力XMLファイルで属性として書き込む入力表の変数名を示す文字ベクトルまたは字符串スカラーで構成されるコンマ区切りのペアとして指定します。

たとえば,入力表の変数名AttName_attにいて,“AttributeSuffix”、“_att”を指定して,“AttName”が出力XMLファescルで属性として書き込まれる必要があることを示します。

  • “AttributeSuffix”を指定しない場合,writetableは既定で出力XMLファescルで属性として変数を接尾辞“属性”を付けて書き込みます。

  • “AttributeSuffix”の値として指定される属性が入力表の変数名に追加される接尾辞に一致する場合,その接尾辞は出力XMLファイルの変数名から除かれます。たとえば,“AttributeSuffix”、“_att”を指定する場合,MyField_attという名前の入力表の変数はXMLファescルのMyFieldという属性に対応します。

例:“AttributeSuffix”、“_att”

XML行ノド名。“RowNodeName”と,書き込み関数が出力XMLファイルに入力表の行に対応するノード名として書き込む文字ベクトルまたは字符串スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。RowNodeNameを指定しない場合,書き込み関数は出力表に行ノ,ドの名前として“行”を書き込みます。

例:“TableNodeName”、“RootName”

XMLルトノド名。“TableNodeName”と,書き込み関数が出力XMLファイルにルートノード名として書き込む文字ベクトルまたは字符串スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。TableNodeNameを指定しない場合,書き込み関数は出力表にル,トノ,ドの名前として“表”を書き込みます。

例:“TableNodeName”、“RootName”

制限

  • writetableは入れ子の表の書き込みをサポ,トしません。入れ子の表にいては,書き込む前にsplitvarsを使用して複数列の変数を1列の変数に分割してください。

ヒント

  • スプレッドシ、トファ、ルに空のシ、トを作成:スプレッドシトファルに空のシトを作成するには,writetableを使用して空の表を書き込みます。たとえば,“MySheetName”という名前の空のシ,トを作成します。

    writetable(表(),“empty.xls”“表”“MySheetName”
    または,“Sheet1”“Sheet2”“Sheet3”という名前の3の空のシトを作成します。
    writetable(表(),“empty.xls”“表”3)

アルゴリズム

  • “WriteVariableNames”“WriteRowNames”の両方の論理ンジケタが真正的の場合,関数writetableは出力の最初の列の列見出しとして,T.Properties.DimensionNamesプロパティから最初の次元の名前を使用します。

  • Excelは値を65535に変換します。MATLAB®NaT,分类値<定义>および字符串値< >失踪を空のセルに変換します。

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

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

    • テキストファ电子邮箱ルを書き込む場合,writetableは,长g形式を使用して数値変数を出力し,直言変数や文字変数は,引用符で囲まれない文字として出力します。

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

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

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

R2013bで導入