sheetnames

Запросить имена листов из datastore

Описание

names = sheetnames(ssds,filename) возвращает имена листов из заданного файла в datastore ssds.

пример

names = sheetnames(ssds,I) возвращает имена листов из заданного индекса файла.

Примеры

свернуть все

Создайте datastore, содержащее файл 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'

Запросите имена листов первого (и только) файла в datastore.

sheetnames(ssds,1)
ans = 

  13×1 string array

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

Входные параметры

свернуть все

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

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

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

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

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

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

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

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

свернуть все

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

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

См. также

Введенный в R2016a