g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_system.a

#include <File.h>
File(STREAM stream = DEF_STREAM);
boolean open(const SysString& filename, MODE mode = READ_ONLY);
boolean put(const SysString& str);
boolean close();

File out(File::ERROR);
File foo_wo;
SysString temp_file;

Integral::makeTemp(temp_file);

if (!foo_wo.open(temp_file, File::WRITE_ONLY)) {
  Console::put(L"Error in open");
}

SysString str1(L"testing output\n");
out.put(str1);

foo_wo.put(str1);

foo_wo.close();

File::remove(temp_file);

• This example shows how to open the file (shown in quick start) and read the string back in:

  // get a temporary file name
  //
  SysString temp_file;
  Integral::makeTemp(temp_file);
         
  // declare a file for writing
  //
  File write_file;
         
  // open the temporary file in write mode
  //
  if (!write_file.open(temp_file, File::WRITE_ONLY)) {
    Console::put(L"Error in open");
  }
  
  // create a string to write and write it to the file
  //
  SysString str1(L"testing output\n");
  write_file.put(str1);
         
  // close the file
  //
  write_file.close();
         
  // create a file for reading
  //
  File read_file;
         
  // open the temporary file for reading
  //
  if (read_file.open(temp_file, File::READ_PLUS)) {
         
    // lock the file so no one can edit it while we read
    //
    read_file.lock();
         
    // get the string out of the file
    //
    SysString str2;
    read_file.get(str2);
         
    // we should have read in the same file that we wrote
    //
    if (str2.ne(L"testing output")) {
      Console::put(L"Error in getString");
    }
         
    // release the file lock and close the file
    //
    read_file.unlock();
    read_file.close();
  }
  else {
    Console::put(L"Error in open");
  }
  
  // delete the temporary file
  //
  File::remove(temp_file);

• The following example demonstrates one way to use the File class to read from stdin and write to stdout.

  // Create file objects.
  //
  File read_stdin;
  File write_stdout;
  
  // Initialize one string to "-"
  // and create a second to store output.
  //
  SysString str1(L"-");
  SysString str2;
  
  // "-" is passed as the first argument to
  // the open method to set the object to access
  // stdin/stdout. The second argument determines
  // whether the File object will read from stdin,
  // or write to stdout.
  //
  // In this case the object will read from stdin.
  //
  if(read_stdin.open(str1, File::READ_ONLY)){ 
    read_stdin.get(str2);
  }
  else { 
    Console::put(L"Error Opening Stdin\n");
  }
  
  // Destroy the object.
  //
  read_stdin.close();  
  
  // Again "-" is passed. This time the object
  // will write to stdout.
  //
  if(write_stdout.open(str1, File::WRITE_ONLY)){
    write_stdout.put(str2);  
  }
  else {
    Console::put(L"Error Opening Stdout");
  }
  
  // Destroy the object.
  //
  write_stdout.close();

• The swap method helps to avoid possible memory problems when multiple pointers point to the same file
  
  
• Temporary files registered through the File::registerTemp() method will automatically be deleted upon exit (through either the normal Integral::exit() or the exception handling Error::exit()). If you generated the name for your temporary files through Integral::makeTemp they will automatically be registered through this system. You can still delete a temporary file if you like with File::remove(), the automated system will only delete those files that still exist.