exponenta event banner

sheetnames

Запрос имен листов из хранилища данных

Описание

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"

Входные аргументы

свернуть все

Хранилище входных данных, указанное как SpreadsheetDatastore объект. Используйте spreadsheetDatastore функции или datastore для создания объекта хранилища данных на основе данных.

Файл в хранилище данных, указанный как вектор символов или строковый скаляр, содержащий имя файла для запроса.

Значение filename должно точно соответствовать имени файла, содержащегося в Files свойства хранилища данных. Чтобы обеспечить точное соответствие имен файлов, укажите filename использование ssds.Files{N} где N - индекс файла в Files собственность.

Пример: names = sheetnames(ssds,ssds.Files{1}) возвращает имена листов, содержащиеся в первом файле, указанном в Files свойство хранилища данных ssds.

Типы данных: char | string

Индекс файла, указанный как положительное целое число. I не может превышать количество файлов в ssds.

Типы данных: double

Выходные аргументы

свернуть все

Имена листов, возвращаемые в виде массива строк, содержащего имена листов в указанном файле.

Типы данных: string

См. также

Представлен в R2016a