xlswrite

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

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

Синтаксис

xlswrite(filename,A)
xlswrite(filename,A,sheet)
xlswrite(filename,A,xlRange)
xlswrite(filename,A,sheet,xlRange)
status = xlswrite(___)
[status,message] = xlswrite(___)

Описание

пример

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)
Warning: Added specified worksheet. 

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

свернуть все

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

Если 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 на рабочем листе. Вход xlRange не является чувствительным к регистру, и использует стиль ссылки Excel A1 (см. справку 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Идентификатор сообщения.

Ограничения

  • Если ваш компьютер не имеет 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 с пользовательскими форматами (такими как шрифты или цвета), получите доступ к серверу Windows COM непосредственно с помощью actxserver, а не xlswrite. Например, этот MathWorks Support Answer использует actxserver, чтобы установить связь между MATLAB и Excel, записывает данные к рабочему листу и задает цвета ячеек.

Алгоритмы

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

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

развернуть все

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

Смотрите также

| | | | |

Представлено до R2006a

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