Changes between Version 8 and Version 9 of ChapterIoFileSystem

Author:

kris (IP: 17.228.23.90)

Timestamp:

05/09/09 01:59:29 (15 years ago)

Comment:

adjusted for FileConduit? changes

ChapterIoFileSystem

@@ -16 +16 @@
-[[Image(source:/trunk/doc/images/classdia.tango.io.FilePath.png)]] 
-
-
+ (see module tango.io.Path for more information)
-
-A number of common file and directory operations are exposed via !FilePath, including creation, renaming, removal, and folder/directory content listing. A handful of attributes such as file size and various timestamps are also made available.
-
-
-!FileConduit
-
-!FileConduit
-
-
-Conduit
+File
+
+File
+
+
+
-}}}
-
-{{{
-#!d
-Conduit ("myFilePath", FileConduit
+ ("myFilePath", File
-}}}
-
-There are a variety of pre-defined styles, including appending, read-only, read-write, create-always and so on. Additional styles can be defined, using a combination of a dozen system-level flags.
-
-!FileConduit
+File
-{{{
-#!d
-// open a file for reading
-Conduit
+
-
-// display file content on console
-#!d
-// open a file for reading
-Conduit
+
-
-// open another for writing
-Conduit ("copy.txt", FileConduit
+ ("copy.txt", File
-
-// copy file
-#!d
-// open file for reading 
-Conduit
+
-
-// create an array to house the entire file
-}}}
-
-!FileConduit
+File
-{{{
-#!d
-// open file for writing 
-Conduit ("text.txt", FileConduit
+ ("text.txt", File
-
-// write an array of content to it 
-
-
-!FileConduit supports random IO also. In this example we relocate the current file position using seek() and, to add a little spice, utilize a !DataS
+File supports random IO also. In this example we relocate the current file position using seek() and, to add a little spice, utilize a Data s
-{{{
-#!d
-// open a file for reading and writing
-Conduit ("random.bin", FileConduit
-
-S
+ ("random.bin", File
+
+ s
-auto input  = new DataInput  (file);
-auto output = new DataOutput (file);
-char[] y = "hello";
-
-Stream
-putInt
-put   
- ()
+
+int32
+array
+
-
-// rewind to file start
-
-// read data back again
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-}}}
-
-[[Image(source:/trunk/doc/images/classdia.tango.io.FileConduit.png)]]
-
-=== !FileConduit Exceptions ===
-
-IO exceptions are raised where a bulk read or write operation fails entirely, or where a copy operation fails to complete. This might happen if, for example, a remote file were to suddenly become unavailable whilst in use.
-
-
-== File ==
-
-File is a simple class for read, write or append file content at once.
-
-[[Image(source:/trunk/doc/images/classdia.tango.io.File.png)]] 
-
-For example, to read all file content:
-{{{
-#!d
-auto file = new File ("myfile");
-auto content = file.read();
-}}}
-
-The underlying file is closed before the call returns. File must avoid making assumptions about the file content, so the above example returns an array of void. When working with text files, it is necessary to cast the return value to represent the correct data type. For text files this is often a char[]:
-{{{
-#!d
-auto file = new File ("myfile");
-auto content = cast(char[]) file.read();
-}}}
-
-To convert a text file into a set of lines, try the following:
-{{{
-#!d
-import Text = tango.text.Util;
-
-auto file = new File ("myfile");
-auto content = cast(char[]) file.read;
-auto lines = Text.splitLines (content);
-}}}
-
-Using a foreach to iterate instead:
-{{{
-#!d
-foreach (line; Text.lines (content))
-         // do something with each line
-}}}
-
-Files can be set to the content of an array:
-{{{
-#!d
-char[] myText;
-
-file.write (myText);
-}}}
-
-File content may be appended in a similar fashion:
-{{{
-#!d
-char[] myText;
-
-file.append (myText);
-}}}
-
-Each of the methods belonging to !FilePath are exposed via the ''path'' method, so you can get the file size, relocate it, remove it, and so on.
-
-=== File Exceptions ===
-
-
-
+
-
-== !FileSystem ==