Main Content

Generate Code to Read a Text File

This example shows how to generate a standalone C library from MATLAB® code that reads a file from disk using the functions fopen/fread/fclose.

About the readfile Function

The readfile.m function takes a file name (or path) as input and returns a string containing the contents of the file.

type readfile
% y = readfile(filename)
% Read file 'filename' and return a MATLAB string with the contents
% of the file.
function y = readfile(filename) %#codegen

% Put class and size constraints on function input.
assert(isa(filename, 'char'));
assert(size(filename, 1) == 1);
assert(size(filename, 2) <= 1024);

% Call fopen(filename 'r'), but we need to convert the MATLAB
% string into a C type string (which is the same string with the
% NUL (\0) string terminator).
f = fopen(filename, 'r');

% Call fseek(f, 0, SEEK_END) to set file position to the end of
% the file.
fseek(f, 0, 'eof');

% Call ftell(f) which will return the length of the file in bytes
% (as current file position is at the end of the file).
filelen = int32(ftell(f));

% Reset current file position
fseek(f,0,'bof');

% Initialize a buffer
maxBufferSize = int32(2^16);
buffer = zeros(1, maxBufferSize,'uint8');

% Remaining is the number of bytes to read (from the file)
remaining = filelen;

% Index is the current position to read into the buffer
index = int32(1);

while remaining > 0
    % Buffer overflow?
    if remaining + index > size(buffer,2)
        fprintf('Attempt to read file which is bigger than internal buffer.\n');
        fprintf('Current buffer size is %d bytes and file size is %d bytes.\n', maxBufferSize, filelen);
        break
    end
    % Read as much as possible from the file into internal buffer

    [dataRead, nread] = fread(f,remaining, 'char');
    buffer(index:index+nread-1) = dataRead;
    n = int32(nread);
    if n == 0
        % Nothing more to read
        break;
    end
    % Did something went wrong when reading?
    if n < 0
        fprintf('Could not read from file: %d.\n', n);
        break;
    end
    % Update state variables
    remaining = remaining - n;
    index = index + n;
end

% Close file
fclose(f);

y = char(buffer(1:index));

Generate the MEX Function for Testing

Generate a MEX function using the codegen command.

codegen readfile
Code generation successful.

Before generating C code, you should first test the MEX function in MATLAB to ensure that it is functionally equivalent to the original MATLAB code and that no run-time errors occur. By default, codegen generates a MEX function named readfile_mex in the current folder. This allows you to test the MATLAB code and MEX function and compare the results.

Run the MEX Function

Call the generated MEX function and display the size of the returned string and its first 100 characters.

y = readfile_mex('readfile.m');
size(y)
ans = 1×2

           1        1857

y(1:100)
ans = 
    '% y = readfile(filename)
     % Read file 'filename' and return a MATLAB string with the contents
     % of th'

Generate C Code

codegen -config:lib readfile
Code generation successful.

Using codegen with the specified -config cfg option produces a standalone C library.

Inspect the Generated Code

By default, the code generated for the library is in the folder codegen/lib/readfile/.

The files are:

dir codegen/lib/readfile/
.                      ..                     _clang-format          buildInfo.mat          codeInfo.mat           codedescriptor.dmr     compileInfo.mat        examples               fileManager.c          fileManager.h          fileManager.o          fread.c                fread.h                fread.o                fseek.c                fseek.h                fseek.o                ftell.c                ftell.h                ftell.o                interface              readfile.a             readfile.c             readfile.h             readfile.o             readfile_data.c        readfile_data.h        readfile_data.o        readfile_emxAPI.c      readfile_emxAPI.h      readfile_emxAPI.o      readfile_emxutil.c     readfile_emxutil.h     readfile_emxutil.o     readfile_initialize.c  readfile_initialize.h  readfile_initialize.o  readfile_rtw.mk        readfile_terminate.c   readfile_terminate.h   readfile_terminate.o   readfile_types.h       rtw_proj.tmw           rtwtypes.h             

Inspect the C Code for the readfile.c Function

type codegen/lib/readfile/readfile.c
/*
 * File: readfile.c
 *
 * MATLAB Coder version            : 24.2
 * C/C++ source code generated on  : 05-Sep-2024 13:46:24
 */

/* Include Files */
#include "readfile.h"
#include "fileManager.h"
#include "fread.h"
#include "fseek.h"
#include "ftell.h"
#include "readfile_data.h"
#include "readfile_emxutil.h"
#include "readfile_initialize.h"
#include "readfile_types.h"
#include <math.h>
#include <stdio.h>
#include <string.h>

/* Function Declarations */
static double rt_roundd_snf(double u);

/* Function Definitions */
/*
 * Arguments    : double u
 * Return Type  : double
 */
static double rt_roundd_snf(double u)
{
  double y;
  if (fabs(u) < 4.503599627370496E+15) {
    if (u >= 0.5) {
      y = floor(u + 0.5);
    } else if (u > -0.5) {
      y = u * 0.0;
    } else {
      y = ceil(u - 0.5);
    }
  } else {
    y = u;
  }
  return y;
}

/*
 * Put class and size constraints on function input.
 *
 * Arguments    : const char filename_data[]
 *                const int filename_size[2]
 *                emxArray_char_T *y
 * Return Type  : void
 */
void readfile(const char filename_data[], const int filename_size[2],
              emxArray_char_T *y)
{
  emxArray_real_T *dataRead;
  double d;
  double *dataRead_data;
  int b_index;
  int i;
  int i2;
  int remaining;
  unsigned char buffer[65536];
  signed char fileid;
  char *y_data;
  boolean_T exitg1;
  if (!isInitialized_readfile) {
    readfile_initialize();
  }
  /*  y = readfile(filename) */
  /*  Read file 'filename' and return a MATLAB string with the contents */
  /*  of the file. */
  /*  Call fopen(filename 'r'), but we need to convert the MATLAB */
  /*  string into a C type string (which is the same string with the */
  /*  NUL (\0) string terminator). */
  fileid = cfopen(filename_data, filename_size);
  /*  Call fseek(f, 0, SEEK_END) to set file position to the end of */
  /*  the file. */
  b_fseek(fileid);
  /*  Call ftell(f) which will return the length of the file in bytes */
  /*  (as current file position is at the end of the file). */
  d = rt_roundd_snf(b_ftell(fileid));
  if (d < 2.147483648E+9) {
    if (d >= -2.147483648E+9) {
      i = (int)d;
    } else {
      i = MIN_int32_T;
    }
  } else if (d >= 2.147483648E+9) {
    i = MAX_int32_T;
  } else {
    i = 0;
  }
  /*  Reset current file position */
  c_fseek(fileid);
  /*  Initialize a buffer */
  memset(&buffer[0], 0, 65536U * sizeof(unsigned char));
  /*  Remaining is the number of bytes to read (from the file) */
  remaining = i;
  /*  Index is the current position to read into the buffer */
  b_index = 1;
  emxInit_real_T(&dataRead);
  exitg1 = false;
  while ((!exitg1) && (remaining > 0)) {
    int qY;
    /*  Buffer overflow? */
    if (b_index > MAX_int32_T - remaining) {
      qY = MAX_int32_T;
    } else {
      qY = remaining + b_index;
    }
    if (qY > 65536) {
      printf("Attempt to read file which is bigger than internal buffer.\n");
      fflush(stdout);
      printf("Current buffer size is %d bytes and file size is %d bytes.\n",
             65536, i);
      fflush(stdout);
      exitg1 = true;
    } else {
      double nread;
      int i1;
      /*  Read as much as possible from the file into internal buffer */
      nread = b_fread(fileid, remaining, dataRead);
      dataRead_data = dataRead->data;
      d = rt_roundd_snf((double)b_index + nread);
      if (d < 2.147483648E+9) {
        if (d >= -2.147483648E+9) {
          qY = (int)d;
        } else {
          qY = MIN_int32_T;
        }
      } else if (d >= 2.147483648E+9) {
        qY = MAX_int32_T;
      } else {
        qY = 0;
      }
      if (qY < -2147483647) {
        qY = MIN_int32_T;
      } else {
        qY--;
      }
      if (b_index > qY) {
        i1 = 0;
        qY = 0;
      } else {
        i1 = b_index - 1;
      }
      qY -= i1;
      for (i2 = 0; i2 < qY; i2++) {
        unsigned char u;
        d = rt_roundd_snf(dataRead_data[i2]);
        if (d < 256.0) {
          if (d >= 0.0) {
            u = (unsigned char)d;
          } else {
            u = 0U;
          }
        } else if (d >= 256.0) {
          u = MAX_uint8_T;
        } else {
          u = 0U;
        }
        buffer[i1 + i2] = u;
      }
      d = rt_roundd_snf(nread);
      if (d < 2.147483648E+9) {
        if (d >= -2.147483648E+9) {
          qY = (int)d;
        } else {
          qY = MIN_int32_T;
        }
      } else if (d >= 2.147483648E+9) {
        qY = MAX_int32_T;
      } else {
        qY = 0;
      }
      if (qY == 0) {
        /*  Nothing more to read */
        exitg1 = true;

        /*  Did something went wrong when reading? */
      } else if (qY < 0) {
        printf("Could not read from file: %d.\n", qY);
        fflush(stdout);
        exitg1 = true;
      } else {
        /*  Update state variables */
        remaining -= qY;
        if ((b_index < 0) && (qY < MIN_int32_T - b_index)) {
          b_index = MIN_int32_T;
        } else if ((b_index > 0) && (qY > MAX_int32_T - b_index)) {
          b_index = MAX_int32_T;
        } else {
          b_index += qY;
        }
      }
    }
  }
  emxFree_real_T(&dataRead);
  /*  Close file */
  cfclose(fileid);
  i = y->size[0] * y->size[1];
  y->size[0] = 1;
  y->size[1] = b_index;
  emxEnsureCapacity_char_T(y, i);
  y_data = y->data;
  for (i = 0; i < b_index; i++) {
    y_data[i] = (signed char)buffer[i];
  }
}

/*
 * File trailer for readfile.c
 *
 * [EOF]
 */