xlswrite

(Не рекомендуемый) Запись файла электронной таблицы Microsoft Excel

xlswrite не рекомендуется. Использовать writetable, writematrix, или writecell вместо этого. Для получения дополнительной информации см. раздел Вопросов совместимости.

Описание

пример

xlswrite(filename,A) записывает матрицу A на первый лист в Microsoft® Excel® рабочая книга электронных таблиц filename начиная с камеры A1.

xlswrite(filename,A,sheet) запись в указанный лист.

xlswrite(filename,A,xlRange) записывает в прямоугольную область, заданную как xlRange в первом листе книги. Используйте синтаксис области значений Excel, например 'A1:C3'.

пример

xlswrite(filename,A,sheet,xlRange) запись в указанный лист и область значений.

status = xlswrite(___) возвращает состояние операции записи, используя любой из входных параметров в предыдущих синтаксисах. Когда операция успешна, состояние 1. В противном случае состояние 0.

[status,message] = xlswrite(___) дополнительно возвращает любое предупреждение или сообщение об ошибке, сгенерированные операцией записи в структуре message.

Примеры

свернуть все

Запись вектора с 7 элементами в файл Excel ®.

filename = 'testdata.xlsx';
A = [12.7 5.02 -98 63.9 0 -.2 56];
xlswrite(filename,A)

Запись смешанных текстовых и числовых данных в файл Excel ® начиная с E1 камер от Sheet2.

filename = 'testdata.xlsx';
A = {'Time','Temperature'; 12,98; 13,99; 14,97};
sheet = 2;
xlRange = 'E1';
xlswrite(filename,A,sheet,xlRange)

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

свернуть все

Имя файла, заданное как вектор символов или строка.

Если filename не существует, xlswrite создает файл, определяя формат на основе заданного расширения. Чтобы создать файл, совместимый с программным обеспечением Excel 97-2003, укажите расширение .xls. Чтобы создать файлы в форматах Excel 2007, задайте расширение .xlsx, .xlsb, или .xlsm. Если вы не задаете расширение, xlswrite использует значение по умолчанию, .xls.

Пример: 'myFile.xlsx' или "myFile.xlsx"

Пример: 'C:\myFolder\myFile.xlsx'

Пример: 'myFile.csv'

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

Входная матрица, заданная как двумерное число, символьный массив или строковые массивы, или, если каждая камера содержит один элемент, массив ячеек.

Если A - массив ячеек, содержащий нечто отличное от скаляра числа или текста, затем xlswrite бесшумно оставляет соответствующую камеру в электронной таблице пустой.

Максимальный размер A массива зависит от связанной версии Excel. Дополнительные сведения о спецификациях и пределах Excel см. в справке Excel.

Пример: [10,2,45;-32,478,50]

Пример: {92.0,'Yes',45.9,'No'}

Пример: "ABCDEF"

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | cell

Имя листа, заданное как одно из следующих:

  • Вектор символов, содержащая имя листа. Имя не может содержать двоеточие (:). Для определения имен листов в файле электронной таблицы используйте xlsfinfo.

  • Положительное целое число, указывающее на индекс листа.

Если sheet не существует, xlswrite добавляет новый лист в конец набора листов. Если sheet - индекс, больший, чем количество листов, xlswrite добавляет пустые листы до тех пор, пока количество листов в книге не будет равно sheet. В любом случае xlswrite генерирует предупреждение о добавлении нового листа.

Типы данных: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Прямоугольная область значений, заданный как вектор символов или строка.

Задайте xlRange использование двух противоположных углов, которые определяют область для записи. Для примера, 'D2:H4' представляет прямоугольную область 3 на 5 между двумя углами D2 и H4 на листе. The xlRange вход не чувствителен к регистру и использует стиль ссылки A1 Excel (см. справку Excel). xlswrite не распознает именованные области значений.

  • Если вы не задаете sheet, затем xlRange должны включать оба угла и символ двоеточия, даже для одной камеры (например 'D2:D2'). В противном случае xlswrite интерпретирует вход как имя листа (например 'D2').

  • Если вы задаете sheet, затем xlRange может задавать только первую камеру (например 'D2'). xlswrite записывает входной массив A начиная с этой камеры.

  • Если xlRange больше, чем размер входа массива A, программное обеспечение Excel заполняет оставшуюся часть области #N/A. Если xlRange меньше, чем размер A, затем xlswrite записывает только подмножество, которое помещается в xlRange в файл.

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

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

свернуть все

Состояние операции записи, возвращенное как 1 (true) или 0 (false). Когда операция записи успешна, status является 1. В противном случае status является 0.

Ошибка или предупреждение, сгенерированные во время операции записи, возвращаются как массив структур, содержащий два поля:

messageТекст предупреждения или сообщения об ошибке.
identifierИдентификатор сообщения.

Ограничения

  • The xlswrite функция не поддерживает запись массивов ячеек, которые содержат различные типы данных при попытке записи файлов CSV.

  • Если на вашем компьютере нет Excel для Windows® или вы используете MATLAB® Online™, затем xlswrite функция:

    • Записывает A массива в текстовый файл в формате значения (CSV), разделенном запятыми. A должна быть числовой матрицей.

    • Игнорирует sheet и xlRange аргументы.

    Это ограничение также применяется, когда COM-сервер (часть типовой установки Excel) недоступен.

Совет

  • Если на компьютере имеется программное обеспечение Microsoft Office 2003, но требуется создать файл в формате Excel 2007, установите пакет совместимости Office 2007.

  • Excel и MATLAB могут хранить даты как текст, который представляет эти даты (такие как '10/31/96') или серийные номера дат (такие как 729329). Если массив включает серийные номера дат, преобразуйте эти даты в текстовое представление с помощью datestr перед вызовом xlswrite.

  • Чтобы записать данные в файлы Excel с пользовательскими форматами (такими как шрифты или цвета), получите доступ к COM-серверу Windows непосредственно с помощью actxserver а не xlswrite. Для примера этот ответ поддержки MathWorks использует actxserver чтобы установить соединение между MATLAB и Excel, записывает данные в лист и задает цвета камер.

Алгоритмы

Excel преобразует Inf значения в 65535. MATLAB преобразует NaN значения для пустых камер.

Вопросы совместимости

расширить все

Не рекомендуемый запуск в R2019a

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте