このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。
tabularTextDatastore
表形式テキストファ▪▪ルのデ▪▪タストア
説明
列方向のデータや表形式データを含むテキストファイルの大規模な集合(必ずしもメモリに収まるとは限らない)を管理するには,TabularTextDatastore
オブジェクトを使用します。表形式デタとは,各行に同数のエントリをも四角形の表として配置されたデタです。関数tabularTextDatastore
を使用してTabularTextDatastore
オブジェクトを作成し,そのプロパティを指定すると,オブジェクト関数を使用してデータのインポートおよび処理ができます。
作成
説明
入力引数
位置
- - - - - -デタストアに含めるファルまたはフォルダ
文件集
オブジェクト|ファ@ @ルパス|DsFileSet
オブジェクト
デタストアに含めるファルまたはフォルダ。文件集
オブジェクト,ファaaplルパス,またはDsFileSet
オブジェクトとして指定します。
文件集
オブジェクト-位置
を文件集
オブジェクトとして指定できます。場所を文件集
オブジェクトとして指定すると,パスまたはDsFileSet
オブジェクトを指定した場合に比べ,デ,タストアの構築時間が短くなります。詳細にいては,matlab.io.datastore.FileSet
を参照してください。ファイルパス——単一のファイルパスを文字ベクトルまたは字符串スカラーとして指定できます。複数のファ▪▪ルパスは文字ベクトルのcell配列またはstring配列として指定できます。
DsFileSet
オブジェクト-DsFileSet
オブジェクトを指定できます。詳細にいては,matlab.io.datastore.DsFileSet
を参照してください。
ファルまたはフォルダはロカルでもリモトでもかまいません。
ロカルのファルまたはフォルダ-ファルまたはフォルダのロカルパスを指定します。現在のフォルダ以外のファルの場合は,絶対パスまたは相対パスを指定します。指定したフォルダーのサブフォルダー内にあるファイルは、自動ではデータ ストアに含まれません。ローカル パスを指定するときにワイルドカード文字 (*) を使用できます。この文字は、一致するフォルダー内にある、すべてのファイルまたは一致するすべてのファイルをデータ ストアに含めることを指定します。
リモトのファルまたはフォルダ-
hdfs: / / /
の形式の统一资源定位符(URL)として,リモートのファイルまたはフォルダーの絶対パスを指定します。詳細にいては,リモ,トデ,タの操作を参照してください。path_to_file
フォルダーを指定する場合,データストアにはサポートされているファイル形式のファイルのみが含まれ,その他の形式のファイルは無視されます。デタストアに含めるファル拡張子のカスタムリストを指定するには,FileExtensions
プロパティを参照してください。
関数tabularTextDatastore
は,. txt
、. csv
、.dat
、.dlm
、.asc
,および。text
の各拡張子のファ@ @ルと拡張子なしのファ@ @ルをサポ@ @トしています。
例:“file1.csv”
例:“. . / dir /数据/ file1”
例:[" C: \ dir \ data \ file1.csv”,“C: \ dir \ data \ file2.dat”)
例:“C: \ dir \ data \ *。
オプションの名称,值
の引数ペアをコンマ区切りで指定します。的名字
は引数名で,价值
は対応する値です。的名字
は引用符で囲まなければなりません。Name1, Value1,…,的家
のように,複数の名前と値のペアの引数を任意の順序で指定できます。
例:ttds = tabularTextDatastore("C:\dir\textdata","FileExtensions",[".csv",".txt"])
FileExtensions
- - - - - -テキストファ@ @ルの拡張子
文字ベクトル|文字ベクトルのcell配列|字符串スカラ|字符串配列
テキストファ@ @ルの拡張子。“FileExtensions”
と,文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列で構成されるコンマ区切りのペアとして指定します。指定する拡張子は,サポ,トされる形式でなくても構いません。サポトされていない拡張子を含める場合は、すべての拡張子を指定してください。空の引用符""
を使用して,拡張子なしでファ。
例:“FileExtensions”、“. txt”
例:“FileExtensions”(“。text”、“. csv”)
デ,タ型:字符
|细胞
|字符串
IncludeSubfolders
- - - - - -サブフォルダ,を含めるかどうかのフラグ
真正的
または假
|0または
サブフォルダ,を含めるかどうかのフラグ。“IncludeSubfolders”
と,真正的
、假
, 0, 1のいずれかで構成される名前と値の引数として指定します。各フォルダ内のすべてのファルとサブフォルダを含めるには真正的
を指定し,各フォルダ,内のファ,ルのみを含めるには假
を指定します。
“IncludeSubfolders”
を指定しない場合,既定値は假
です。
例:“IncludeSubfolders”,真的
デ,タ型:逻辑
|双
AlternateFileSystemRoots
- - - - - -代替ファ▪▪ルシステムのル▪▪トパス
字符串ベクトル|细胞配列
代替ファ▪▪ルシステムのル▪▪トパス。“AlternateFileSystemRoots”
と字符串ベクトルまたは单元格配列で構成される名前と値の引数として指定します。ローカルマシン上にデータストアを作成するが,別のマシン(異なるオペレーティングシステムの可能性がある)上でデータにアクセスして処理する必要がある場合は,“AlternateFileSystemRoots”
を使用します。また,并行计算工具箱™とMATLAB®并行服务器™を使用してデータを処理し,そのデータがローカルマシンに保存され,そのデータのコピーが異なるプラットフォームのクラウドやクラスターマシンにある場合,“AlternateFileSystemRoots”
を使用してル,トパスを関連付けなければなりません。
相互に対応する1組のル,トパスを関連付けるには,
“AlternateFileSystemRoots”
を字符串ベクトルとして指定します。たとえば,次のようになります。[" Z: \数据集”、“/ mynetwork /数据集”)
デ,タストアに対応する複数の組のル,トパスを関連付けるには,複数行を含むcell配列として
“AlternateFileSystemRoots”
を指定します。各行は対応するル,トパスの組を表します。细胞配列内の各行を string ベクトル、または文字ベクトルの cell 配列のいずれかとして指定します。以下に例を示します。“AlternateFileSystemRoots”
を字符串ベクトルの单元格配列として指定します。{[Z: \“数据集”、“/ mynetwork /数据集”);…[" Y: \数据集”、“/ mynetwork2 /数据集”、“年代:\数据集”)}
あるいは,
“AlternateFileSystemRoots”
を文字ベクトルのcell配列からなるcell配列として指定します。{{“Z: \数据集”、“mynetwork /数据集”},…{“Y: \数据集”,“mynetwork2 /数据集”,年代:\数据集的}}
“AlternateFileSystemRoots”
の値は,次の条件を満たさなければなりません。
1 .行以上の行を含み,各行は1 .組の対応するル,トパスを指定する。
各行は複数のル,トパスを指定し,各ル,トパスは2文字以上を含まなければならない。
ル,トパスは一意で,他のル,トパスのサブフォルダ,ではない。
ファ▪▪ルの場所を指す1▪▪以上のル▪トパスエントリを含む。
詳細にいては,異なるマシンまたはクラスタ,で処理するためのデ,タストアの設定を参照してください。
例:[" Z: \数据集”、“/ mynetwork /数据集”)
デ,タ型:字符串
|细胞
TextType
- - - - - -テキスト変数の出力デ,タ型
“字符”
(既定値) |“字符串”
テキスト変数の出力デ,タ型。“TextType”
と“字符”
または“字符串”
のいずれかで構成されるコンマ区切りのペアとして指定します。関数读
、readall
または预览
の出力表にテキスト変数が含まれる場合,“TextType”
はTabularTextDatastore
でのそれらの変数のデ,タ型を指定します。“TextType”
が“字符”
の場合,出力は文字ベクトルの单元格配列です。“TextType”
が“字符串”
の場合,出力の型は字符串
です。
デ,タ型:字符
|字符串
DatetimeType
- - - - - -インポートされる日付と時刻のデータの型
“datetime”
(既定値) |“文本”
。“DatetimeType”
と,“datetime”
または“文本”
のいずれかの値で構成されるコンマ区切りのペアとして指定します。
値 | インポートされる日付と時刻のデータの型 |
---|---|
“datetime” |
MATLABの 詳細にいては, |
“文本” |
|
指定したTextscanFormats
プロパティに% D
が含まれる場合,tabularTextdatastore
はDatetimeType
で指定された値を無視します。
例:“DatetimeType”、“datetime”
デ,タ型:字符
|字符串
DurationType
- - - - - -持续时间デ,タの出力デ,タ型
“持续时间”
(既定値) |“文本”
持续时间デ,タの出力デ,タ型。“DurationType”
と“持续时间”
または“文本”
のいずれかで構成される名前と値の引数として指定します。
値 | インポートされる时间データの型 |
---|---|
“持续时间” |
MATLABの 詳細にいては, |
“文本” |
|
デ,タ型:字符
|字符串
DatetimeLocale
- - - - - -日付を解釈するロケ,ル。
“en_US”
(既定値) |文字ベクトル|字符串スカラ
日付を解釈するためのロケ,ル。文字ベクトルまたは字符串スカラとして指定します。DatetimeLocale
値は,。
DatetimeLocale
を指定する場合,
の形式を使用します。ここでxx
_YY
xx
はiso 639-1で定義された小文字2文字の言語コドで,YY
はISO 3166-1 alpha-2で定義された大文字の国コ,ドです。
次の表に一般的なロケ,ルの値を示します。
ロケル | 言語 | 国 |
---|---|---|
“de_DE” |
ドere語 | ド |
“en_GB” |
英語 | 英国 |
“en_US” |
英語 | 米国 |
“es_ES” |
スペ@ @ン語 | スペereplicationン |
“fr_FR” |
フランス語 | フランス |
“it_IT” |
タリア語 | タリア |
“ja_JP” |
日本語 | 日本 |
“ko_KR” |
韓国語 | 韓国 |
“设置nl_NL” |
オランダ語 | オランダ |
“zh_CN” |
簡体字中国語 | 中国 |
メモ
语言环境
値により,入力値の解釈方法が決まります。表示形式と言語は,[基本設定]ウィンドウの[日付と時刻の形式]セクションの[ロケ,ル]オプションによって指定されます。既定の日付と時刻のロケルを変更する方法にいては,コマンドウィンドウ基本設定の設定を参照してください。
デ,タ型:字符
|字符串
これらの名前と値のペアに加えて,このペ,ジのプロパティも名前と値のペアとして指定できます。ただし,文件
プロパティを除きます。
プロパティ
TabularTextDatastore
プロパティは,TabularTextDatastore
オブジェクトに関連付けられているファ@ @ルを記述します。具体的には,プロパティはファイル内のデータの形式を記述し,データストアからデータを読み取る方法を制御します。TabularTextDatastore
オブジェクトの作成時に,デ,タストア関数は文件
プロパティ内の最初のファesc escルを使用して,そのプロパティの値を決定します。文件
プロパティを除いて,数据存储オブジェクトの作成時に,名前と値のペアの引数を使用してTabularTextDatastore
プロパティの値を指定できます。オブジェクトの作成後にプロパティの表示または変更を行うには、ドット表記を使用します。
ds = tabularTextDatastore(“airlinesmall.csv”);ds。TreatAsMissing =“NA”;ds。MissingValue = 0;
ファ@ @ルプロパティ
文件
- - - - - -デタストアに含まれるファル
文字ベクトルのcell配列|字符串配列
デタストアに含まれるファル。文字ベクトルのcell配列または字符串配列として解決されます。各文字ベクトルまたは string はファイルへの絶対パスです。関数tabularTextDatastore
および関数数据存储
の位置
引数がこれらのファ@ @ルを定義します。
文件
プロパティで最初に指定するファイルは,データストアのすべてのファイルに対する変数名と形式の情報を決定します。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
例:{“C: \ dir \ data \ mydata1.csv”;“C: \ dir \ data \ mydata2.csv”}
デ,タ型:细胞
|字符串
FileEncoding
- - - - - -ファ▪▪ルのエンコ▪▪ド
“utf - 8”
(既定値) |“us - ascii”
|“麦金塔”
|……
ファ▪▪ルのエンコ▪▪ド。次の値のいずれかのような文字ベクトルまたは字符串スカラ,として指定します。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
|
デタストア内の各ファルがメモリに収まる場合,FileEncoding
は次の値のいずれかにすることもできます。
|
|
|
|
|
|
|
|
|
|
|
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
デ,タ型:字符
|字符串
ReadVariableNames
- - - - - -変数名の読み取り
真正的
|假
変数名の読み取り。逻辑真正的
または逻辑假
として指定します。
指定しない場合,関数
tabularTextDatastore
は変数名の有無を自動的に検出します。真正的
の場合,最初のファルの最初の非ヘッダ行がそのデタの変数名を決定します。假
の場合,最初のファルの最初の非ヘッダ行にそのデタの1行目が含まれます。デ,タには既定の変数名がVar1
、Var2
などと順に割り当てられます。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
デ,タ型:逻辑
VariableNamingRule
- - - - - -変数名を保持するかどうかのフラグ
“修改”
(既定値) |“保存”
変数名を保持するかどうかのフラグ。“修改”
または“保存”
として指定します。
“修改”
-無効な変数名(関数isvarname
で判定)を,有効なmatlab識別子に変換。“保存”
——スペースや非ASCII文字を含む変数名など,有効なMATLAB識別子ではない変数名を保持。
R2019b以降,変数名と行名には,スペースや非ASCII文字など任意の文字を含めることができます。また,英字だけでなく任意の文字で始めることができます。変数名と行名は,有効なmatlab識別子(関数isvarname
で判定)である必要はありません。これらの変数名と行名を保持するには,VariableNamingRule
の値を“保存”
に設定します。VariableNamingRule
の値を“修改”
から“保存”
に変更すると,変数名が更新されなくなります。
デ,タ型:字符
|字符串
VariableNames
- - - - - -変数名
文字ベクトルのcell配列|字符串配列
デ,タストア内の変数名。文字ベクトルの细胞配列または字符串配列として指定します。ファereplicationルに表示される順序で変数名を指定します。変数名を指定しない場合は、データ ストアの最初のファイルの最初の非ヘッダー行から検出されます。VariableNames
プロパティを変更する場合,新しい変数名の数は,元の変数名の数と一致しなければなりません。
スペースおよび非ASCII文字を含む変数名など,無効なMATLAB識別子を変数名としてサポートするには,VariableNamingRule
パラメ,タ,の値を“保存”
に設定します。
ReadVariableNames
が假
の場合,VariableNames
は既定値の{“Var1”、“Var2”…}
になります。
例:{“时间”、“名称”、“数量”}
デ,タ型:细胞
|字符串
テキスト形式のプロパティ
NumHeaderLines
- - - - - -スキップする行数
非負の整数
ファ@ @ルの先頭からスキップする行数。非負の整数として指定します。指定しない場合,関数tabularTextDatastore
はスキップする行数を自動的に検出します。
関数tabularTextDatastore
は,指定したヘッダ,の行数を無視してから,変数名またはデ,タを読み取ります。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
デ,タ型:双
分隔符
- - - - - -フィ,ルドの区切り記号
文字ベクトル|文字ベクトルのcell配列|字符串スカラ|字符串配列
フィ,ルドの区切り記号。文字ベクトル、文字ベクトルのcell配列、字符串スカラまたは字符串配列として指定します。複数の区切り記号は,文字ベクトルの单元格配列または字符串配列で指定します。指定しない場合,関数tabularTextDatastore
は区切り記号を自動的に検出します。
例:“|”
例:{“;”,“*”}
ファイル内で連続する区切り文字を,それらの間に空のフィールドをもつ個別の区切り記号として解釈します。指定しない場合,既定で読み取り関数が自動的に区切り記号を検出します。
次のエスケープシーケンスの1つを区切り記号として指定した場合,そのシーケンスを対応する制御文字に変換します。
\ b |
バックスペ,ス |
\ n |
改行 |
r \ |
キャリッジリタ,ン |
\ t |
タブ |
\ \ |
バックスラッシュ(\ ) |
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
デ,タ型:字符
|细胞
|字符串
RowDelimiter
- - - - - -行区切り記号文字
\ r \ n
(既定値) |文字ベクトル|字符串スカラ
行区切り記号文字。文字ベクトルまたは字符串スカラとして指定します。これは単一の文字か,“\ r”
、“\ n”
または“\ r \ n”
のいずれかでなければなりません。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
例:”:“
デ,タ型:字符
|字符串
TreatAsMissing
- - - - - -欠損値として処理するテキスト
""
(既定値) |文字ベクトル|文字ベクトルのcell配列|字符串スカラ|字符串配列
欠損値として処理するテキスト。単一の文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列として指定します。TreatAsMissing
として指定された値には,MissingValue
プロパティで定義された値が代入されます。たとえば,MissingValue
が南
として定義され,TreatAsMissing
が“NA”
として定義されたとします。その場合,“NA”
が南
に置き換えられます。
このオプションは数値フィ,ルドのみに適用されます。また,このプロパティは,関数textscan
の名前と値のペア引数TreatAsEmpty
と等価です。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
例:“NA”
例:{“-””、“}
デ,タ型:字符
|细胞
|字符串
MissingValue
- - - - - -欠損値フィ,ルドの値
南
(既定値) |スカラ
区切りテキストファ▪▪ル内の欠損値フィ▪▪ルドの値。スカラ,として指定します。このプロパティは,関数textscan
の名前と値のペア引数EmptyValue
と等価です。
デ,タ型:双
高度なテキスト形式のプロパティ
TextscanFormats
- - - - - -デ,タフィ,ルドの形式
文字ベクトルのcell配列|字符串配列
デ,タフィ,ルドの形式。文字ベクトルの细胞配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変換指定子を含みます。
TextscanFormats
プロパティを指定または変更する場合,関数textscan
がformatSpec
引数に対して受け入れるものと同じ変換指定子を使用できます。TextscanFormats
の有効値には,アスタリスク(*)文字を使用してフィールドをスキップする変換指定子と,リテラルテキストをスキップする変換指定子が含まれます。変換指定子の数は,VariableNames
プロパティ内の変数の数と一致しなければなりません。
TextscanFormats
の値にアスタリスク文字(*)を使用してフィルドをスキップする変換指定子が含まれる場合,SelectedVariableNames
プロパティの値は自動的に更新されます。MATLABは% *问
変換指定子を使用してSelectedVariableNames
プロパティで省略されたフィールドをスキップし,フィールドの内容をリテラル文字ベクトルとして処理します。固定幅のファイルについては,適切な変換指定子をフィールド幅と共に使用してスキップするフィールドを指定します。たとえば,% * 52 c
は52文字を含むフィ,ルドをスキップします。TextscanFormats
に値を指定しない場合,数据存储
は,データストアにある最初のファイルの最初の非ヘッダー行からテキストをスキャンすることにより,データフィールドの形式を決定します。R2020b以降,
数据存储
は,接頭辞付きリテラルを16進数およびバ。以前は,数据存储
は接頭辞付きリテラルをテキストデ,タとして検出していました。
例:{“% s”、“% s”、“% f”}
デ,タ型:细胞
|字符串
ExponentCharacters
- - - - - -指数文字
“eEdD”
(既定値) |文字ベクトル|字符串スカラ
指数文字。文字ベクトルまたは字符串スカラ,として指定します。既定の指数文字はe
、E
、d
およびD
です。
デ,タ型:字符
|字符串
CommentStyle
- - - - - -コメント文字
""
(既定値) |文字ベクトル|字符串スカラ|2 要素配列
ファ@ @ル内のコメントを識別するために使用されるコメント文字。文字ベクトル、字符串スカラ、2 要素 string または cell 配列として指定します。
文字ベクトルまたは字符串スカラーを指定すると,同じ行の以降のテキストはすべてコメントと解釈されます。たとえば,
“CommentStyle”、“/ *”
では,同じ行の/*
の後のすべてのテキストがコメントとして解釈されます。文字ベクトルを含む2要素弦ベクトルまたは2要素细胞配列を指定すると,2つの文字の間にあるすべてのテキストがコメントとして解釈されます。たとえば,
“CommentStyle ",{"/*", "*/"}
では,“/ *”
から“* /”
までのすべてのテキストがコメントとして解釈されます。
TabularTextDatastore
から読み取る場合,関数读
は,各フィールドの先頭のみコメントをチェックします(フィールド内はコメントチェック対象外です)。
このプロパティ値を変更すると,関数数据存储
はTabularTextDatastore
のプロパティ値を再評価します。
例:“CommentStyle ",{"/*", "*/"}
デ,タ型:字符
|细胞
|字符串
空格
- - - - - -空白文字
“t \ b \”
(既定値) |文字ベクトル|字符串スカラ
空白文字。1文字以上の文字ベクトルまたは字符串スカラ,として指定します。
次のエスケプシケンスの1を空白文字として指定した場合,関数数据存储
は,シ,ケンスを対応する制御文字に変換します。
\ b |
バックスペ,ス |
\ n |
改行 |
r \ |
キャリッジリタ,ン |
\ t |
タブ |
\ \ |
バックスラッシュ(\ ) |
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
例:“t \ b \”
デ,タ型:字符
|字符串
MultipleDelimitersAsOne
- - - - - -複数の区切り記号の取り扱い
0(假)
(既定値) |1(真正的)
複数の区切り記号の取り扱い。真正的
または假
のいずれかとして指定します。真正的
の場合,数据存储
は連続した区切り記号を1の区切り記号として扱います。区切り記号が空白で分けられて繰り返された場合も,1の区切り記号として扱われます。
このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastore
のプロパティ値を再評価します。
预览
、读
、readall
テ,ブルのプロパティ
SelectedVariableNames
- - - - - -読み取る変数
文字ベクトルのcell配列|字符串配列
ファ@ @ルから読み取る変数。文字ベクトルの细胞配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変数の名前を含みます。変数名は任意の順序で指定できます。
スペースおよび非ASCII文字を含む変数名など,無効なMATLAB識別子を変数名としてサポートするには,VariableNamingRule
パラメ,タ,の値を“保存”
に設定します。
例:[" Var3”、“Var7”、“Var4”)
デ,タ型:细胞
|字符串
SelectedFormats
- - - - - -選択した変数の形式
文字ベクトルのcell配列|字符串配列
選択した読み取り対象の変数の形式。文字ベクトルのcell配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変換指定子を含みます。読み取り対象の変数は,SelectedVariableNames
プロパティで指定されます。SelectedFormats
内の文字ベクトルまたは字符串の数は,読み取り対象の変数の数と一致しなければなりません。
関数textscan
が受け入れた変換指定子と同じ指定子を使用できます。これにはリテラルテキストをスキップする指定子が含まれます。ただし,フィ,ルドをスキップする変換指定子は使用できません。まり,変換指定子にアスタリスク文字(*)を含めることはできません。
例:[" % d”、“% d”)
デ,タ型:细胞
|字符串
ReadSize
- - - - - -読み取るデ,タの量
20000(既定値) |正のスカラ|“文件”
関数读
の1回の呼び出しで読み取るデ,タの量。正のスカラ,または“文件”
として指定します。
ReadSize
が正の整数の場合,读
へのそれぞれの呼び出しは最大でReadSize
の行数を読み取ります。ReadSize
が“文件”
の場合,读
を呼び出すたびに,1のファ。
ReadSize
を数値スカラ,から“文件”
に変更したり,その逆の変更を行うと,MATLABはデータストアをデータの読み取り前の状態にリセットします。
デ,タ型:双
|字符
|字符串
TextType
- - - - - -テキスト変数の出力デ,タ型
“字符”
(既定値) |“字符串”
テキスト変数の出力デ,タ型。“字符”
または“字符串”
として指定します。TextType
は,% s
、%问
または[…]
で書式設定されたテキスト変数のデ,タ型を指定します。
TextType
が“字符”
の場合,出力は文字ベクトルの单元格配列です。TextType
が“字符串”
の場合,出力の型は字符串
です。
デ,タ型:字符
|字符串
RowTimes
- - - - - -行時間変数の名前
変数名|変数@ @ンデックス
行時間変数の名前。“RowTimes”
と変数名(“日期”
など)または変数龋ンデックス(3.
など)で構成される名前と値の引数として指定します。
RowTimes
は时间表に関連するパラメ,タ,です。时间表の各行は、timetable の時間ベクトルに記録されている時間に関連付けられます。RowTimes
内に指定される変数は,datetime
ベクトルまたは持续时间
ベクトルを含まなければなりません。
“OutputType”
の値が“时间表”
だが“RowTimes”
を指定しない場合,TabularTextDatastore
は,最初のdatetime
変数または持续时间
変数を时间表の行時間として使用します。
writeall
で使用するプロパティ
文件夹
- - - - - -デタストアの作成に使用するフォルダ
文字ベクトルのcell配列
このプロパティは読み取り専用です。
デタストアの作成に使用するフォルダ。文字ベクトルのcell配列として返されます。cell 配列は列ベクトルとして方向付けされます。各文字ベクトルは、データ ファイルを含むフォルダーへのパスです。関数tabularTextDatastore
および関数数据存储
の位置
引数は,デ,タストアの作成時に文件夹
を定義します。
TabularTextDatastore
オブジェクトの文件
プロパティを変更すると,文件夹
プロパティがリセットされます。
デ,タ型:细胞
金宝appSupportedOutputFormats
- - - - - -書き込みでサポ,トされる形式のリスト
行ベクトル
このプロパティは読み取り専用です。
書き込みでサポ,トされる形式のリスト。字符串の行ベクトルとして返されます。このプロパティは、writeall
を使用してデタストアから出力ファルを書き込む際に使用可能な出力形式を指定します。
デ,タ型:字符串
DefaultOutputFormat
- - - - - -既定の出力形式
字符串スカラ
このプロパティは読み取り専用です。
既定の出力形式。字符串スカラとして返されます。このプロパティは、writeall
を使用してデタストアから出力ファルを書き込む際の既定の形式を指定します。
デ,タ型:字符串
オブジェクト関数
hasdata |
デ,タが読み取り可能かどうかを判別 |
numpartitions |
デ,タストアの区画数 |
分区 |
デ,タストアを分割する |
预览 |
デタストア内のデタのサブセットをプレビュ |
读 |
デ,タストアのデ,タの読み取り |
readall |
デ,タストアのすべてのデ,タの読み取り |
writeall |
ファ▪▪ルへのデ▪▪タストアの書き込み |
重置 |
デ,タストアの初期状態へのリセット |
变换 |
デ,タストアの変換 |
结合 |
複数のデ,タストアのデ,タを統合 |
isPartitionable |
デ,タストアが分割可能かどうかを判別 |
isShuffleable |
デ,タストアがシャッフル可能かどうかを判別 |
例
読み取る変数の選択
FileSetオブジェクトまたはファaapl .ルパスを使用して,サンプルファaapl .ルairlinesmall.csv。
からデ,タストアを作成します。欠損値を扱う方法を指定します。対象の変数のみを選択します。
ファereplicationルairlinesmall.csv
からFileSetオブジェクトを作成します。値が“NA”
の場合は欠損として扱い,欠損値を0
として扱うデ,タストアを作成します。
fs = matlab.io.datastore.FileSet(“airlinesmall.csv”);ds = tabularTextDatastore(fs,“TreatAsMissing”,“NA”,...“MissingValue”, 0);
デ,タストア内の変数を表示します。
ds。VariableNames
ans =1 x29单元格第1至5列{'年'}{'月'}{'月日'}{'周日'}{'DepTime'}第6至9列{'CRSDepTime'} {'ArrTime'} {'CRSArrTime'} {'UniqueCarrier'}第10至13列{'FlightNum'} {'TailNum'} {'ActualElapsedTime'} {'CRSElapsedTime'} 14至18列{'AirTime'} {'ArrDelay'} {'DepDelay'} {'Origin'} {'Dest'}第19至22列{'Distance'} {'TaxiIn'} {'TaxiOut'} {'Cancelled'}第23至25列{'CancellationCode'} {' '} {'CarrierDelay'}}第26至28列{'WeatherDelay'} {'NASDelay'} {'SecurityDelay'}第29列{'LateAircraftDelay'}
SelectedVariableNames
プロパティを変更して対象の変数を指定します。
ds。SelectedVariableNames = [“年”,“月”,“取消”];
あるいは,デ,タの場所をファ,ルパスとして指定することもできます。
ds = tabularTextDatastore(“airlinesmall.csv”);
いずれかの場所の形式を使用して,対象の変数をデ,タストアの作成時に指定することもできます。
ds = tabularTextDatastore(“airlinesmall.csv”,“TreatAsMissing”,“NA”,...“MissingValue”0,“SelectedVariableNames”,[“年”,“月”,“取消”]);
読み取るデ,タの書式の指定
表形式デタが格納されたサンプルファルairlinesmall.csv
からデ,タストアを作成します。
ds = tabularTextDatastore(“airlinesmall.csv”,“TreatAsMissing”,“NA”,...“MissingValue”, 0);
対象の変数を指定します。
ds。SelectedVariableNames = [“年”,“月”,“UniqueCarrier”];
SelectedFormats
プロパティを表示します。
ds。SelectedFormats
ans =1 x3单元格{'%f'} {'%f'} {'%q'}
SelectedFormats
プロパティは,関数tabularTextDatastore
による変数の形式の解釈方法を指定します。変数一年
および月
は浮動小数点値の列として読み取られ,変数UniqueCarrier
はテキストの列として読み取られます。
SelectedFormats
プロパティを変更して,最初の2つの変数を符号付き整数として読み取り,3番目の変数を直言値として読み取ります。
ds。SelectedFormats = [“% d”,“% d”,“% C”];
デ,タをプレビュ,します。
T =预览(ds)
T =8×3表年月唯一承运人_________ _____________ 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS
表形式テキストデ,タストアから时间表を返す
OutputType
およびRowTimes
の名前と値のペアを使用して,tabulartextDatastore
から表ではなく时间表が返されるようにします。
outages.csv
のデ,タストアを作成します。名前と値のペア”OutputType
“を”时间表
として指定します。
ttds = tabularTextDatastore(“outages.csv”,“OutputType”,“时间表”);预览(运输大亨)
ans =8×5时间表OutageTime地区客户RestorationTime造成损失 ________________ _____________ ______ __________ ________________ ___________________ 2002-02-01 12:18{“西南”}458.98 - 1.8202 e + 06 2002-02-07 16:50{“暴风雪”}2003-01-23 00:49{“东南”}530.14 - 2.1204 e + 05 NaT{“暴风雪”}2003-02-07)21:15{“东南”}289.4 - 1.4294 e + 05 2003-02-17 08:14{“暴风雪”}2004-04-06 05:44{‘西方’}434.81 - 3.4037 e + 05 2004-04-06 06:10{“设备故障”}2002-03-16 06:18 186.44{“中西部”}2.1275e+05 2002-03-18 23:23{'严重风暴'}2003-06-18 02:49{'西'}00 2003-06-18 10:54{'攻击'}2004-06-20 14:39{'西'}231.29 NaN 2004-06-20 19:16{'设备故障'}2002-06-06 19:28{'西'}311.86 NaN 2002-06-07 00:51{'设备故障'}
“RowTimes”
を併せて指定しない場合,tabularTextDatastore
は,最初のdatetime変数またはduration変数を行時間として使用します。この場合は,変数OutageTime
が行時間に使用されます。
“RowTimes”
オプションを指定して,停電時刻ではなく復旧時刻(変数RestorationTime
)を行時間として使用します。
ttds = tabularTextDatastore(“outages.csv”,“OutputType”,“时间表”,“RowTimes”,“RestorationTime”);预览(运输大亨)
ans =8×5时间表RestorationTime地区OutageTime客户造成损失 ________________ _____________ ________________ ______ __________ ___________________ 2002-02-07 16:50{“西南”}2002-02-01 12:18 458.98 - 1.8202 e + 06{“暴风雪”}NaT{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05{“暴风雪”}2003-02-17 08:14{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 05{“暴风雪”}2004-04-06 06:10{‘西方’}2004-04-06 05:44 434.81 - 3.4037 e + 05{“设备故障”}2002-03-18 23:23{“中西部”}2002-03-16 06:18 186.44 2.1275e+05{'严重风暴'}2003-06-18 10:54{'西'}2003-06-18 02:49 00{'攻击'}2004-06-20 19:16{'西'}2004-06-20 14:39 231.29 NaN{'设备故障'}2002-06-07 00:51{'西'}2002-06-06 19:28 311.86 NaN{'设备故障'}
制限
en_US
ロケール以外の言語で日,月,またはタイムゾーンの名前を含むdatetimeデータはサポートされません。認識されないdatetime形式の場合は,TextscanFormats
パラメ,タ,を使用して形式を指定します。
バ,ジョン履歴
Matlabコマンド
次のmatlabコマンドに対応するリンクがクリックされました。
コマンドをmatlabコマンドウィンドウに入力して実行してください。Webブラウザ,はMATLABコマンドをサポ,トしていません。
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。