xlswrite

(Не рекомендуемый) файл электронной таблицы Write 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 на рабочем листе. 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 ложь). Когда операция записи успешна, 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

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