int fgetc (fileid)
int fileid;

where:

This macro returns the contents of the next byte from a file. The fgetc macro name is short for [file getc() ], where file indicates that the macro operates on a file, and getc is the standard function for getting a character from a user defined file. This is distinct from the getchar function, which can only retrieve a character from the standard input, and is typically the keyboard.

fgetc returns the contents of the next memory location byte from the specified file. You define the identity of the file with the fopen macro (see fopen on fopen), or the FOPEN command (see FOPEN on FOPEN). Any file used to read, or get, the contents of the next byte, must be opened in read mode.

The file read from must be opened in read mode, for example:

fopen(100,”c:\\myfiles\\data_in.txt”,”r”)

This example shows how to use fgetc, together with fopen and fputc:

define /R void copyFile()
{
  int retval;
  int ch;
  // Create data file to read
  retval = fopen(100,”c:\\myfiles\\data_in.txt”,”w”);
  if (retval < 0)
    error(2,"Cannot open file for writing!\n",101);
  else {
    retval = fwrite("1234567890\n1234567890\n1234567890", 1, 32, 100);
    $vclose 100$;
    fopen(100,”c:\\myfiles\\data_in.txt”,”r”);       // open for read-only
    if (retval < 0)
      error(2,"Source file not opened!\n",101);
    else
      fopen(200,”c:\\myfiles\data_out.txt”,”w”);    // open for writing
      if (retval < 0)
        error(2,"Destination file not opened!\n",101);
      else
        do {
          ch = fgetc(100);                            // fgetc()
          if (ch < 0)
            $printf "Finished copying the file!"$;
          else
            fputc(ch,200);                            // fputc()
        } while (ch > 0);
    }
    $vclose 100$;
    $vclose 200$;
  }
}
.

The following macros provide similar or related functionality:

The following commands provide similar or related functionality: