External Interfaces/API

RecordMode

Specify whether data and event information are saved to one record file or to multiple record files

Description

You can configure RecordMode to be overwrite, append, or index. If RecordMode is overwrite, then the record file is overwritten each time recording is initiated. If RecordMode is append, then data is appended to the record file each time recording is initiated. If RecordMode is index, a different record file is created each time recording is initiated, each with an indexed filename.

You can configure RecordMode only when the object is not recording. You terminate recording with the record function. A object that is not recording has a RecordStatus property value of off.

You specify the record filename with the RecordName property. The indexed filename follows a prescribed set of rules. Refer to Specifying a Filename for a description of these rules.

Characteristics

Read only	While recording
Data type	String

Values

{overwrite}	The record file is overwritten.
append	Data is appended to an existing record file.
index	A different record file is created, each with an indexed filename.

Example

Suppose you create the serial port object s associated with the serial port COM1.

• s = serial('COM1');
  fopen(s)
  

Specify the record filename with the RecordName property, configure RecordMode to index, and initiate recording.

• s.RecordName = 'MyRecord.txt';
  s.RecordMode = 'index';
  record(s)
  

The record filename is automatically updated with an indexed filename after recording is turned off.

• record(s,'off')
  s.RecordName
  ans =
  MyRecord01.txt
  

Disconnect s from the peripheral device, remove s from memory, and remove s from the MATLAB workspace.

• fclose(s)
  delete(s)
  clear s
  

See Also

Functions

record

Properties

RecordDetail, RecordName, RecordStatus

RecordDetail

RecordName