|MATLAB Function Reference|
Read one line of text from the device and discard the terminator
||A serial port object.
||Text read from the instrument, excluding the terminator.
||The number of values read, including the terminator.
||A message indicating if the read operation was unsuccessful.
tline = fgetl(obj)
reads one line of text from the device connected to
obj, and returns the data to
tline. The returned data does not include the terminator with the text line. To include the terminator, use
[tline,count] = fgetl(obj)
returns the number of values read to
[tline,count,msg] = fgetl(obj)
returns a warning message to
msg if the read operation was unsuccessful.
Before you can read text from the device, it must be connected to
obj with the
fopen function. A connected serial port object has a
Status property value of
open. An error is returned if you attempt to perform a read operation while
obj is not connected to the device.
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 - each time
fgetl is issued.
If you use the
help command to display help for
fgetl, then you need to supply the pathname shown below.
Rules for Completing a Read Operation with fgetl
A read operation with
fgetl blocks access to the MATLAB command line until:
Terminatorproperty is reached.
Create the serial port object
s to a Tektronix TDS 210 oscilloscope, and write the
RS232? command with the
RS232? instructs the scope to return serial port communications settings.
Because the default value for the
ReadAsyncMode property is
continuous, data is automatically returned to the input buffer.
fgetl to read the data returned from the previous write operation, and discard the terminator.
s from the scope, and remove
s from memory and the workspace.