D Documentation  
[ Home ][ Up ]
  1. Introduction
    1. A simple tutorial
    2. Switching to D
    3. An advanced tutorial
  2. Language Reference
    1. General syntax
    2. Statements
    3. Types
    4. Error Handling
    5. Memory Management
  3. Std. runtime library (Phobos)
    1. std.base64
    2. std.boxer
    3. std.compiler
    4. std.conv
    5. std.ctype
    6. std.date
    7. std.file
      1. FileException
      2. exists
      3. isfile
      4. isdir
      5. read
      6. write
      7. append
      8. remove
      9. rename
      10. getSize
      11. getAttributes
      12. getcwd
      13. chdir
      14. mkdir
      15. rmdir
      16. listdir
    8. std.format
    9. std.gc
    10. std.intrinsic
    11. std.math
    12. std.md5
    13. std.mmfile
    14. std.outbuffer
    15. std.path
    16. std.process
    17. std.random
    18. std.recls
    19. std.regexp
    20. std.socket
    21. std.socketstream
    22. std.stdint
    23. std.stdio
    24. std.stream
    25. std.string
    26. std.system
    27. std.thread
    28. std.uri
    29. std.utf
    30. std.zip
    31. std.zlib
  4. Libraries and Tools
    1. mango
    2. Build
  5. Related Links
  6. About this documentation
read 
void[] read(char[] name)

This function reads a file name and returns an array of bytes.
It can throw a FileException, if the file does not exist (anymore) or can not be read.

Example:
// Import standard-in-out
import std.stdio;
import std.file;

// Main function
int main(char[][] args)
{
  char[] content;
  // This program reads a file and prints it to the screen
  try
  {
    content = cast(char[])read(args[1]);
    writefln(content);
  }
  catch (FileException xy)
  {
    writefln();
    writefln("A file exception occured: " ~ xy.toString());
  }
  catch (Exception xx)
  {
    writefln();
    writefln("An exception occured: " ~ xx.toString());
  }
  return 0;
}

See also:
FileException, exists, isfile, write, append, remove, rename
Created using PHP docwiki written by Markus Dangl. Best viewed with Mozilla Firefox.