Read data from instrument, format as text, and parse
A = scanstr(obj)
A = scanstr(obj,'delimiter')
A = scanstr(obj,'delimiter','
[A,count] = scanstr(...)
[A,count,msg] = scanstr(...)
An interface object.
One or more delimiters used to parse the data.
C language conversion specification.
Data read from the instrument and formatted as text.
The number of values read.
A message indicating if the read operation was unsuccessful.
A = scanstr(obj) reads
formatted data from the instrument connected to
parses the data using both a comma and a semicolon delimiter, and
returns the data to the cell array
A. Each element
of the cell array is determined to be either a double or a string.
A = scanstr(obj,'delimiter') parses
the data into separate variables based on the specified
be a single character or a string array. If
a string array, then each character in the array is used as a delimiter.
A = scanstr(obj,'delimiter',' converts
the data according to the specified
be a matrix or a cell array depending on
textread help for complete
format is a string containing
C language conversion specifications.
Conversion specifications involve the % character and the conversion
characters d, i, o, u, x, X, f, e, E, g, G, c, and s. See the
sscanf file I/O format specifications
or a C manual for complete details.
format is not specified, then
the best format (either a double or a string) is chosen.
[A,count] = scanstr(...) returns
the number of values read to
[A,count,msg] = scanstr(...) returns
a warning message to
msg if the read operation
did not complete successfully.
Create the GPIB object
g associated with
a National Instruments® board with index 0 and primary address
2, and connect
g to a Tektronix® TDS 210 oscilloscope.
g = gpib('ni',0,2); fopen(g)
Return identification information to separate elements of a cell array using the default delimiters.
fprintf(g,'*IDN?'); idn = scanstr(g) idn = 'TEKTRONIX' 'TDS 210' [ 0] 'CF:91.1CT FV:v1.16 TDS2CM:CMV:v1.04'
Before you can read data from the instrument, it must be connected
obj with the
A connected interface object has a
open. An error is returned if you attempt
to perform a read operation while
obj is not connected
to the instrument.
msg is not included as an output argument
and the read operation was not successful, then a warning message
is returned to the command line.
ValuesReceived property value is increased
by the number of values read — including the terminator —
scanstr is issued.