mode_of- The Iostreams library supports eight modes, described in the next section (see also Figure 2). Of these, four are most import (see Figure 1). The two modes input and output are by far the most common. Readers new to the Iostreams library should feel free to concentrate primarily on these two modes. + The Iostreams library supports eight modes, described in the next section (see also Figure 2). Of these, four are most import (see Figure 1). The two modes input and output are by far the most common. Readers new to the Iostreams library should feel free to concentrate primarily on these two modes.
@@ -168,8 +168,8 @@ For more on the selection of modes, see the Rationale. - -The following diagrams display the refinement hierarchies among modes.
Index: libs/iostreams/doc/classes/device.html =================================================================== --- libs/iostreams/doc/classes/device.html (revision 76959) +++ libs/iostreams/doc/classes/device.html (working copy) @@ -26,7 +26,7 @@
- The class template device, its subcass wdevice and their specializations source, sink, wsource and wsink are provided by the Iostreams library to ease the definitions of new models of the various Device Concepts. These templates and typedefs are inteded to be used as base classes for user-defined Devices. They supply the member types char_type and category used by the Iostreams library.
+ The class template device, its subcass wdevice and their specializations source, sink, wsource and wsink are provided by the Iostreams library to ease the definitions of new models of the various Device Concepts. These templates and typedefs are intended to be used as base classes for user-defined Devices. They supply the member types char_type and category used by the Iostreams library.
The supplied category member is convertible to closable_tag and to localizable_tag. This allows users to define models of the concepts Closable and Localizable simply by providing definitions of member functions close and imbue.
Index: libs/iostreams/doc/tutorial/container_source.html
===================================================================
--- libs/iostreams/doc/tutorial/container_source.html (revision 76959)
+++ libs/iostreams/doc/tutorial/container_source.html (working copy)
@@ -53,7 +53,7 @@
Here the member type char_type indicates the type of characters handled by my_source, which will almost always be char or wchar_t. The member type category indicates which of the fundamental i/o operations are supported by the device. The category tag source_tag indicates that only read is supported.
The member function read reads up to n character into the buffer s and returns the number of character read, unless that number is 0 and end-of-stream has been reached, in which case the special value -1 is returned. In general, a Source's member function read may return fewer characters than requested even though end-of-stream has not been reached; such Sources are called non-blocking. Non-blocking Devices do not interact well with standard streams and stream buffers, however, so most devices should be Blocking. See Asynchronous and Non-Blocking I/O.
The member function read reads up to n characters into the buffer s and returns the number of characters read, unless that number is 0 and end-of-stream has been reached, in which case the special value -1 is returned. In general, a Source's member function read may return fewer characters than requested even though end-of-stream has not been reached; such Sources are called non-blocking. Non-blocking Devices do not interact well with standard streams and stream buffers, however, so most devices should be Blocking. See Asynchronous and Non-Blocking I/O.
You could also write the above example as follows:
Index: libs/iostreams/doc/tutorial/writing_filters.html =================================================================== --- libs/iostreams/doc/tutorial/writing_filters.html (revision 76959) +++ libs/iostreams/doc/tutorial/writing_filters.html (working copy) @@ -27,7 +27,7 @@Filters are used to modify character sequences. For example, you might use a filter to replace all instances of one word with another, to convert all alphabetic characters to lower case or to encrypt a document. Sometimes the filter is a mere observer; in this case the filtered character sequence if the same as the unfiltered sequence. For example, you might use a filter to count the number of occurences of a given word.
+Filters are used to modify character sequences. For example, you might use a filter to replace all instances of one word with another, to convert all alphabetic characters to lower case or to encrypt a document. Sometimes the filter is a mere observer; in this case the filtered character sequence if the same as the unfiltered sequence. For example, you might use a filter to count the number of occurrences of a given word.
Index: libs/iostreams/doc/concepts/multi_character.html =================================================================== --- libs/iostreams/doc/concepts/multi_character.html (revision 76959) +++ libs/iostreams/doc/concepts/multi_character.html (working copy) @@ -1,7 +1,7 @@ -Filter which provides access to its controlled sequence or sequences several characters at a time. The difference between a Filter which is Mutli-Character and one which is not is reflected in the specifications of the various Filter refinements. See, e.g., InputFilter and OutputFilter.
+Filter which provides access to its controlled sequence or sequences several characters at a time. The difference between a Filter which is Multi-Character and one which is not is reflected in the specifications of the various Filter refinements. See, e.g., InputFilter and OutputFilter.