ファイルの種類。“文件类型”と,許可されたファイルタイプ(“汽车”、“垫”、“铺”、“>”、“文本”,または“表格”)のいずれかで構成されるコンマ区切りのペアとして指定します。

“文件类型”の名前と値のペアを位置引数と共に使用して,どのような種類のファイルを書き込むかを指定します。既定では,写は適切なファイルタイプを自動検出するよう試みます。写が位置またはfilepattern引数の拡張子からファイルタイプを判定できる場合,名前と値のペアの引数“文件类型”を指定する必要はありません。写は,次の拡張子からファイルタイプを判定できます。

例:写入('C:\myData'， tX， 'FileType'， 'text')

カスタム書き込み関数。“WriteFcn”と関数ハンドルで構成されるコンマ区切りのペアとして指定します。指定した関数は助教からデータのブロックを受け取り,出力ファイルの作成を受け持ちます。写が出力形式を直接にサポートしていない場合でも,名前と値のペアの引数“WriteFcn”を使用して,さまざまな形式でデータを書き込むことができます。

関数シグネチャ

カスタム書き込み関数は,信息と数据の2つの入力引数を受け入れなければなりません。

函数myWriter(信息,数据)

ファイルの命名

出力ファイルに使用されるファイル名によって,後ほど数据存储がファイルを読み戻す順序が決定されます。ファイルの順序が重要である場合は,SuggestedFilenameフィールドを使用してファイルに命名することをお勧めします。推奨される名前によってファイルの順序が確定されるからです。推奨されるファイル名を使用しない場合,カスタム書き込み関数はグローバルに一意な,正しく順序付けられたファイル名を作成しなければなりません。ファイル名は,RequiredFilePatternで概説されている命名パターンに従う必要があります。并行计算工具箱™での並列実行に際しては,各ワーカーが独自のローカルフォルダーに書き込む場合でも,ファイル名はワーカー間で一意であり,かつ正しく順序付けられていなければなりません。

複数の区画をもつ配列

高配列を区画に分けて,配列に対する并行计算工具箱での並列計算を実行しやすくすることができます。それぞれの区画はさらに,個々がメモリに収まる,より小さなブロックで構成されています。

信息には,PartitionIndex、NumPartitions、BlockIndexInPartition、IsFinalBlockなど,区画に関連するいくつかのフィールドが含まれています。これらのフィールドは,単一のファイルを書き込み,そこに追加していく場合に便利です。これは,多くのブロックに分割された大きな区画をもつ配列では,一般的に行われるタスクです。カスタム書き込み関数はブロックごとに 1 回呼び出され、1 つの区画内のブロックは常に、同じワーカーによって順番に書き込まれます。ただし、別々の区画は別々のワーカーによって書き込まれる可能性があります。

関数の例

スプレッドシートファイルを書き込む単純な書き込み関数は,次のとおりです。

函数dataWriter(info, data) filename = info. suggestedfilename;writetable(数据、文件名“文件类型”，“表格”）结束

tt =高(array2table (rand (5000 3)));位置=“/ tmp / MyData / tt_ * .xlsx”；写(位置、tt“WriteFcn”, @dataWriter);

データ型:function_handle

変数名を列見出しとして書き込むためのインジケーター。“WriteVariableNames”と,数値もしくは逻辑の1（真正的)または0（假)で構成されるコンマ区切りのペアとして指定します。

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

Excel^®ファイルの場合,写はdatetime配列を含む変数をExcelの日付として書き込み,“DateLocale”パラメーターの値は無視します。datetime1900年の変数にまたは1904年よりも前の年が含まれている場合,写はその変数をテキストとして書き込みます。Excelの日付の詳細については,Excel中1900年和1904年日期系统的差异を参照してください。

例:“DateLocale”、“ja_JP”または“DateLocale”、“ja_JP”

データ型:字符|字符串

フィールドの区切り記号。“分隔符”と次の指定子のいずれかで構成されるコンマ区切りのペアとして指定します。

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

例:“分隔符”、“空间”または“分隔符”,“空间”

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

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

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

例:“编码”、“系统”または“编码”,“系统”ではシステムの既定のエンコードを使用します。

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

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

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

例:“表”，2

例:“表”，“MySheetName”

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

镶木地板の圧縮アルゴリズム。次の値のいずれかとして指定します。

一般に,“时髦的”の読み取りと書き込みのパフォーマンスは高く,“gzip”はCPU処理時間が長くなりますが圧縮率が高く,“brotli”は通常,圧縮速度が低下しますが最小ファイルサイズを作成します。

例:写入('C:\myData'， tX， 'FileType'， 'parquet'， 'VariableCompression'， 'brotli')

例:写入('C:\myData'， tX， 'FileType'， 'parquet'， 'VariableCompression'， {'brotli' ' 'snappy' ' 'gzip'})

エンコードスキーム名。次の値のいずれかとして指定します。

一般に,“字典”エンコードによってファイルサイズが小さくなりますが,繰り返しの値が多く含まれていない変数については“普通”エンコードの方がより高速になりえます。ディクショナリのサイズまたは一意の値の数が過度に大きくなると,エンコードは自動的に平原エンコードに戻ります。镶木地板エンコードの詳細については,剧场正厅座位编码定义を参照してください。

例:(“myData写。parquet'， T， 'FileType'， 'parquet'， 'VariableEncoding'， 'plain')

例:(“myData写。parquet'， T， 'FileType'， 'parquet'， 'VariableEncoding'， {'plain' '字典' 'plain'})

使用する铺バージョン。“1.0”または“2.0”のいずれかとして指定します。既定では,“2.0”が最も効率的なストレージを提供しますが,拼花形式をサポートする外部アプリケーションとの最も幅広い互換性を実現するために“1.0”を選択することもできます。