Programming

Controlling Position in a File

Once you open a file with fopen, MATLAB maintains a file position indicator that specifies a particular location within a file. MATLAB uses the file position indicator to determine where in the file the next read or write operation will begin. The following sections describe how to

• Determine whether the file position indicator is at the end of the file
• Move to a specific location in the file
• Retrieve the current location of the file position indicator
• Reset the file position indicator to the beginning of the file

Determining End-of-File

The fseek and ftell functions let you set and query the position in the file at which the next input or output operation takes place:

• The fseek function repositions the file position indicator, letting you skip over data or back up to an earlier part of the file.
• The ftell function gives the offset in bytes of the file position indicator for a specified file.

The syntax for fseek is

• status = fseek(fid,offset,origin)
  

fid is the file identifier for the file. offset is a positive or negative offset value, specified in bytes. origin is one of the following strings that specify the location in the file from which to calculate the position.

'bof'	Beginning of file
'cof'	Current position in file
'eof'	End of file

Understanding File Position

To see how fseek and ftell work, consider this short M-file:

• A = 1:5;
  fid = fopen('five.bin','w');
  fwrite(fid, A,'short');
  status = fclose(fid);
  

This code writes out the numbers 1 through 5 to a binary file named five.bin. The call to fwrite specifies that each numerical element be stored as a short. Consequently, each number uses two storage bytes.

Now reopen five.bin for reading:

• fid = fopen('five.bin','r');
  

This call to fseek moves the file position indicator forward 6 bytes from the beginning of the file:

• status = fseek(fid,6,'bof');
  
  
  
  

This call to fread reads whatever is at file positions 7 and 8 and stores it in variable four:

• four = fread(fid,1,'short');
  

The act of reading advances the file position indicator. To determine the current file position indicator, call ftell:

• position = ftell(fid)
  
  position = 
  
       8 
  
  
  
  

This call to fseek moves the file position indicator back 4 bytes:

• status = fseek(fid,-4,'cof');
  
  
  
  

Calling fread again reads in the next value (3):

• three = fread(fid,1,'short');
  

Writing Binary Data

Reading Strings Line by Line from Text Files

© 1994-2005 The MathWorks, Inc.