sheetnames

データストアからシート名をクエリする

構文

names = sheetnames(ssds,filename)

names = sheetnames(ssds,I)

説明

names = sheetnames(ssds,filename) は、データストア ssds 内の指定されたファイルからシート名を返します。

names = sheetnames(ssds,I) は、指定されたファイル インデックスからシート名を返します。

例

シート名をクエリする

ファイル airlinesmall_subset.xlsx を含むデータストアを作成します。

ssds = spreadsheetDatastore('airlinesmall_subset.xlsx')

ssds = 

  SpreadsheetDatastore with properties:

                      Files: {
                             ' ...\matlab\toolbox\matlab\demos\airlinesmall_subset.xlsx'
                             }
   AlternateFileSystemRoots: {}
                     Sheets: ''
                      Range: ''
            ReadFailureRule: 'error'
                MaxFailures: Inf

  Sheet Format Properties:
             NumHeaderLines: 0
          ReadVariableNames: true
              VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableTypes: {'double', 'double', 'double' ... and 26 more}

  Properties that control the table returned by preview, read, readall:
      SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
      SelectedVariableTypes: {'double', 'double', 'double' ... and 26 more}
                   ReadSize: 'file'

データストア内の最初 (かつ唯一) のファイルのシート名をクエリします。

sheetnames(ssds,1)

ans = 

  13×1 string array

    "1996"
    "1997"
    "1998"
    "1999"
    "2000"
    "2001"
    "2002"
    "2003"
    "2004"
    "2005"
    "2006"
    "2007"
    "2008"

入力引数

ssds — 入力データストア

SpreadsheetDatastore オブジェクト

入力データストア。SpreadsheetDatastore オブジェクトとして指定します。データから datastore オブジェクトを作成するには、関数 spreadsheetDatastore または関数 datastore を使用します。

filename — データストア内のファイル

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

データストア内のファイル。クエリするファイルの名前を含む文字ベクトルまたは string スカラーとして指定します。

filename の値は、データストアの Files プロパティに含まれるファイル名と完全に一致しなければなりません。ファイル名を完全に一致させるには、ssds.Files{N} を使用して filename を指定します。ここで N は Files プロパティ内のファイルのインデックスです。

例: names = sheetnames(ssds,ssds.Files{1}) は、データストア ssds の Files プロパティで指定された最初のファイルに含まれるシート名を返します。

データ型: char | string

I — ファイル インデックス

正の整数

ファイル インデックス。正の整数として指定します。I は ssds 内のファイル数を超えることはできません。

データ型: double

出力引数

names — シート名

string 配列

シート名。指定されたファイル内のシート名を含む string 配列として返されます。

データ型: string

バージョン履歴

R2016a で導入

参考

spreadsheetDatastore