scanstr

Считывайте данные с инструмента, форматируйте как текст и анализируйте

Синтаксис

A = scanstr(obj)
A = scanstr(obj,'delimiter')
A = scanstr(obj,'delimiter','format')
[A,count] = scanstr(...)
[A,count,msg] = scanstr(...)

Аргументы

obj

Объект интерфейса.

'delimiter'

Один или несколько разделителей, используемых для анализа данных.

'format'

Спецификация преобразования языка C.

A

Данные считываются с инструмента и форматируются как текст.

count

Количество считанных значений.

msg

Сообщение, указывающее, была ли операция чтения неудачной.

Описание

A = scanstr(obj) считывает форматированные данные из инструмента, подключенного к obj, анализирует данные с помощью разделителя запятой и точкой с запятой и возвращает данные в массив ячеек A. Каждый элемент массива ячеек определяется как двойной или символьный вектор.

A = scanstr(obj,'delimiter') анализирует данные в отдельные переменные на основе заданных delimiter. delimiter может быть одиночным символом или вектором символов массивом. Если delimiter является массивом векторов символов, тогда каждый символ массива используется в качестве разделителя.

A = scanstr(obj,'delimiter','format') преобразует данные в соответствии с заданной format. A может быть матрицей или массивом ячеек в зависимости от format. См. textread помощь для получения полной информации. format является спецификацией преобразования строки , содержащей C.

Конверсионные спецификации включают символ % и конверсионные символы d, меня, o, u, x, X, f, e, E, g, G, c, и s. Посмотрите sscanf спецификации формата ввода-вывода файла или руководство на C для получения полной информации.

Если format не задан, затем выбирается оптимальный формат (либо двойной, либо вектор символов).

[A,count] = scanstr(...) возвращает количество значений, считанных в count.

[A,count,msg] = scanstr(...) возвращает предупреждающее сообщение в msg если операция чтения не завершилась успешно.

Примеры

Создайте объект GPIB g связанные с National Instruments ™® плата с индексом 0 и основным адресом 2 и соединить g в Tektronix® осциллограф TDS 210.

g = gpib('ni',0,2);
fopen(g)

Возвращает идентификационную информацию в отдельные элементы массива ячеек с помощью разделителей по умолчанию.

fprintf(g,'*IDN?');
idn = scanstr(g)
idn = 
    'TEKTRONIX'
    'TDS 210'
    [        0]
    'CF:91.1CT FV:v1.16 TDS2CM:CMV:v1.04'

Совет

Прежде чем вы сможете считать данные с прибора, он должен быть подключен к obj с fopen функция. Связанный объект интерфейса имеет Status значение свойства open. Ошибка возвращается, если вы пытаетесь выполнить операцию чтения во время obj не соединяется с прибором.

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

The ValuesReceived значение свойства увеличивается на количество значений, считанных - включая терминатор строки - каждый раз scanstr выдается.

Примечание

Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции на MATLAB® командная строка. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой расширенной функции заполнения клавишей Tab, смотрите Использование заполнения клавишей Tab для функций.

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

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

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

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

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

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

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

См. также

Функции

Свойства

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