Ticket #6530: 20120207_fixed_typos_part_1.patch
File 20120207_fixed_typos_part_1.patch, 28.0 KB (added by , 11 years ago) |
---|
-
boost/iostreams/stream.hpp
31 31 typedef Tr traits_type; 32 32 typedef typename category_of<Device>::type mode; 33 33 typedef typename 34 iostreams::select< // Dis mbiguation required for Tru64.34 iostreams::select< // Disambiguation required for Tru64. 35 35 mpl::and_< 36 36 is_convertible<mode, input>, 37 37 is_convertible<mode, output> … … 43 43 BOOST_IOSTREAMS_BASIC_OSTREAM(char_type, traits_type) 44 44 >::type stream_type; 45 45 typedef typename 46 iostreams::select< // Dis mbiguation required for Tru64.46 iostreams::select< // Disambiguation required for Tru64. 47 47 mpl::and_< 48 48 is_convertible<mode, input>, 49 49 is_convertible<mode, output> … … 57 57 }; 58 58 59 59 // By encapsulating initialization in a base, we can define the macro 60 // BOOST_IOSTREAMS_DEFINE_FORWARDING_FUNCTIONS to generate const uctors60 // BOOST_IOSTREAMS_DEFINE_FORWARDING_FUNCTIONS to generate constructors 61 61 // without base member initializer lists. 62 62 template< typename Device, 63 63 typename Tr = … … 96 96 // Template name: stream. 97 97 // Description: A iostream which reads from and writes to an instance of a 98 98 // designated device type. 99 // Template param ters:99 // Template parameters: 100 100 // Device - A device type. 101 101 // Alloc - The allocator type. 102 102 // -
boost/iostreams/detail/adapter/range_adapter.hpp
36 36 // 37 37 // Template name: range_adapter 38 38 // Description: Device based on an instance of boost::iterator_range. 39 // Template param ters:39 // Template parameters: 40 40 // Mode - A mode tag. 41 41 // Range - An instance of iterator_range. 42 42 // -
boost/iostreams/detail/buffer.hpp
30 30 // 31 31 // Template name: buffer 32 32 // Description: Character buffer. 33 // Template param ters:33 // Template parameters: 34 34 // Ch - The character type. 35 35 // Alloc - The Allocator type. 36 36 // … … 69 69 // Template name: buffer 70 70 // Description: Character buffer with two pointers accessible via ptr() and 71 71 // eptr(). 72 // Template param ters:72 // Template parameters: 73 73 // Ch - A character type. 74 74 // 75 75 template< typename Ch, -
boost/iostreams/detail/restrict_impl.hpp
56 56 // 57 57 // Template name: restricted_indirect_device. 58 58 // Description: Provides an restricted view of an indirect Device. 59 // Template param ters:59 // Template parameters: 60 60 // Device - An indirect model of Device that models either Source or 61 61 // SeekableDevice. 62 62 // … … 88 88 // 89 89 // Template name: restricted_direct_device. 90 90 // Description: Provides an restricted view of a Direct Device. 91 // Template param ters:91 // Template parameters: 92 92 // Device - A model of Direct and Device. 93 93 // 94 94 template<typename Device> … … 118 118 // 119 119 // Template name: restricted_filter. 120 120 // Description: Provides an restricted view of a Filter. 121 // Template param ters:121 // Template parameters: 122 122 // Filter - An indirect model of Filter. 123 123 // 124 124 template<typename Filter> -
boost/iostreams/detail/streambuf/chainbuf.hpp
31 31 // Template name: chainbuf. 32 32 // Description: Stream buffer which operates by delegating to the first 33 33 // linked_streambuf in a chain. 34 // Template param ters:34 // Template parameters: 35 35 // Chain - The chain type. 36 36 // 37 37 template<typename Chain, typename Mode, typename Access> -
boost/iostreams/tee.hpp
31 31 32 32 // 33 33 // Template name: tee_filter. 34 // Template param ters:34 // Template parameters: 35 35 // Device - A blocking Sink. 36 36 // 37 37 template<typename Device> … … 99 99 100 100 // 101 101 // Template name: tee_device. 102 // Template param ters:102 // Template parameters: 103 103 // Device - A blocking Device. 104 104 // Sink - A blocking Sink. 105 105 // -
boost/iostreams/chain.hpp
84 84 // 85 85 // Concept name: Chain. 86 86 // Description: Represents a chain of stream buffers which provides access 87 // to the first buffer in the chain and send notifications when the87 // to the first buffer in the chain and sends notifications when the 88 88 // streambufs are added to or removed from chain. 89 89 // Refines: Closable device with mode equal to typename Chain::mode. 90 90 // Models: chain, converting_chain. -
boost/iostreams/filter/counter.hpp
25 25 26 26 // 27 27 // Template name: basic_counter. 28 // Template param ters:28 // Template parameters: 29 29 // Ch - The character type. 30 30 // Description: Filter which counts lines and characters. 31 31 // -
boost/iostreams/filter/aggregate.hpp
33 33 34 34 // 35 35 // Template name: aggregate_filter. 36 // Template param ters:36 // Template parameters: 37 37 // Ch - The character type. 38 38 // Alloc - The allocator type. 39 39 // Description: Utility for defining DualUseFilters which filter an -
boost/iostreams/filter/line.hpp
31 31 32 32 // 33 33 // Template name: line_filter. 34 // Template param ters:34 // Template parameters: 35 35 // Ch - The character type. 36 36 // Alloc - The allocator type. 37 37 // Description: Filter which processes data one line at a time. -
boost/iostreams/compose.hpp
55 55 // 56 56 // Template name: composite_device. 57 57 // Description: Provides a Device view of a Filter, Device pair. 58 // Template param ters:58 // Template parameters: 59 59 // Filter - A model of Filter. 60 60 // Device - An indirect model of Device. 61 61 // … … 115 115 // 116 116 // Template name: composite_device. 117 117 // Description: Provides a Device view of a Filter, Device pair. 118 // Template param ters:118 // Template parameters: 119 119 // Filter - A model of Filter. 120 120 // Device - An indirect model of Device. 121 121 // -
boost/iostreams/close.hpp
73 73 boost::iostreams::close(t, snk, BOOST_IOS::out); 74 74 } 75 75 76 } // End namespace sdetail.76 } // End namespace detail. 77 77 78 78 } } // End namespaces iostreams, boost. 79 79 -
boost/iostreams/invert.hpp
36 36 37 37 // 38 38 // Template name: inverse. 39 // Template param ters:39 // Template parameters: 40 40 // Filter - A model of InputFilter or OutputFilter. 41 41 // Description: Generates an InputFilter from an OutputFilter or 42 42 // vice versa. … … 151 151 152 152 // 153 153 // Template name: invert. 154 // Template param ters:154 // Template parameters: 155 155 // Filter - A model of InputFilter or OutputFilter. 156 156 // Description: Returns an instance of an appropriate specialization of inverse. 157 157 // -
boost/iostreams/combine.hpp
37 37 // 38 38 // Template name: combined_device. 39 39 // Description: Model of Device defined in terms of a Source/Sink pair. 40 // Template param ters:40 // Template parameters: 41 41 // Source - A model of Source, with the same char_type and traits_type 42 42 // as Sink. 43 43 // Sink - A model of Sink, with the same char_type and traits_type … … 77 77 // 78 78 // Template name: combined_filter. 79 79 // Description: Model of Device defined in terms of a Source/Sink pair. 80 // Template param ters:80 // Template parameters: 81 81 // InputFilter - A model of InputFilter, with the same char_type as 82 82 // OutputFilter. 83 83 // OutputFilter - A model of OutputFilter, with the same char_type as … … 179 179 // 180 180 // Template name: combine. 181 181 // Description: Takes a Source/Sink pair or InputFilter/OutputFilter pair and 182 // returns a Reource or Filter which performs input using the first member182 // returns a Source or Filter which performs input using the first member 183 183 // of the pair and output using the second member of the pair. 184 // Template param ters:184 // Template parameters: 185 185 // In - A model of Source or InputFilter, with the same char_type as Out. 186 186 // Out - A model of Sink or OutputFilter, with the same char_type as In. 187 187 // -
libs/iostreams/doc/classes/grep_filter.html
30 30 The class template <CODE>basic_grep_filter</CODE> filters a character sequence line by line using a regular expression provided at construction, in a manner similar to the command-line utility <i>grep</i> (<A CLASS="bib_ref" HREF="../bibliography.html#grep">[IEEE]</A>). The filter uses regular expressions from the <A HREF="http://www.boost.org/libs/regex" TARGET="_top">Boost Regular Expression Library</A> (<A CLASS="bib_ref" HREF="../bibliography.html#maddock">[Maddock]</A>). 31 31 </P> 32 32 <P> 33 By default, the filtered character sequence consists of those lines of the unfil itered sequence that contain a subsequence matching the regular expression. By specifying appropriate options at construction, <CODE>basic_grep_filter</CODE> can be made to pass through only those lines which exactly match the regular expression (as if the option <i>-x</i> had been passed to the command-line utility) or only those lines that <i>do not</i> contain a match (as if the option <i>-v</i> had been passed to the command-line utility).33 By default, the filtered character sequence consists of those lines of the unfiltered sequence that contain a subsequence matching the regular expression. By specifying appropriate options at construction, <CODE>basic_grep_filter</CODE> can be made to pass through only those lines which exactly match the regular expression (as if the option <i>-x</i> had been passed to the command-line utility) or only those lines that <i>do not</i> contain a match (as if the option <i>-v</i> had been passed to the command-line utility). 34 34 </P> 35 35 <P> 36 36 A running count of the lines in the filtered character sequence is available via the member function <code><a href="#count">count</a></code>. -
libs/iostreams/doc/tutorial/writing_devices.html
41 41 42 42 <P>Here <CODE>io::stream_buffer<my_device></CODE> is a derived class of <CODE>std::basic_streambuf</CODE>, and <CODE>io::stream<my_device></CODE> is a derived class of <CODE>std::basic_istream</CODE>, <CODE>std::basic_ostream</CODE> or <CODE>std::basic_iostream</CODE> depending on the <A HREF="../guide/modes.html">mode</A> of my_device, <I>i.e.</I>, depending on which of the fundamental i/o operations <A HREF="../functions/read.html"><CODE>read</CODE></A>, <A HREF="../functions/write.html"><CODE>write</CODE></A> and <A HREF="../functions/seek.html"><CODE>seek</CODE></A> it supports. 43 43 44 <P>The template <CODE>io::stream</CODE> is provided as a convenience. It's always possibl yto avoid <CODE>io::stream</CODE> and simply use <CODE>io::stream_buffer</CODE> together with one of the standard library stream templates. <I>E.g.</I>,44 <P>The template <CODE>io::stream</CODE> is provided as a convenience. It's always possible to avoid <CODE>io::stream</CODE> and simply use <CODE>io::stream_buffer</CODE> together with one of the standard library stream templates. <I>E.g.</I>, 45 45 46 46 <PRE CLASS="broken_ie"><SPAN CLASS='preprocessor'>#include</SPAN> <SPAN CLASS='literal'><ostream></SPAN> 47 47 <SPAN CLASS='preprocessor'>#include</SPAN> <A CLASS="HEADER" HREF="../../../../boost/iostreams/device/file.hpp"><SPAN CLASS='literal'><boost/iostreams/device/file.hpp></SPAN></A> -
libs/iostreams/doc/tutorial/dictionary_filters.html
27 27 <H2>2.2.6. Dictionary Filters</H2> 28 28 29 29 <P> 30 A <SPAN CLASS='term'>dictionary filter</SPAN> is a Filter which pe forms text substitution in the following manner. It maintains a collection of pairs of strings whose first components are words and whose second components represent replacement text — I'll call such a collection a <SPAN CLASS='term'>dictionary</SPAN>, and refer to the pairs it contains as <SPAN CLASS='term'>definitions</SPAN>. When a dictionary filter encounters a word which appears as the first component of a definition, it forwards the replacement text instead of the original word. Other words, whitespace and punctuation are forwarded unchanged.30 A <SPAN CLASS='term'>dictionary filter</SPAN> is a Filter which performs text substitution in the following manner. It maintains a collection of pairs of strings whose first components are words and whose second components represent replacement text — I'll call such a collection a <SPAN CLASS='term'>dictionary</SPAN>, and refer to the pairs it contains as <SPAN CLASS='term'>definitions</SPAN>. When a dictionary filter encounters a word which appears as the first component of a definition, it forwards the replacement text instead of the original word. Other words, whitespace and punctuation are forwarded unchanged. 31 31 </P> 32 32 33 33 <P> 34 The basic algorithm is as follows .: You examine characters one at a time, appending them to a string which I'll call the <SPAN CLASS='term'>current word</SPAN>. When you encounter a non-alphabetic character, you consult the dictionary to determine whether the current word appears as the first component of a definition. If it does, you forward the replacement text followed by the non-alphabetic character. Otherwise, you forward the current word followed by the non-alphabetic character. When the end-of-stream is reached, you consult the dictionary again and forward either the curent word or its replacement, as appropriate.34 The basic algorithm is as follows: You examine characters one at a time, appending them to a string which I'll call the <SPAN CLASS='term'>current word</SPAN>. When you encounter a non-alphabetic character, you consult the dictionary to determine whether the current word appears as the first component of a definition. If it does, you forward the replacement text followed by the non-alphabetic character. Otherwise, you forward the current word followed by the non-alphabetic character. When the end-of-stream is reached, you consult the dictionary again and forward either the curent word or its replacement, as appropriate. 35 35 </P> 36 36 37 37 <P> … … 59 59 } } } <SPAN CLASS="comment">// End namespace boost::iostreams:example</SPAN></PRE> 60 60 61 61 <P> 62 The member function <CODE>add</CODE> converts <CODE>key</CODE> to lower case then addedthe pair <CODE>key</CODE>, <CODE>value</CODE> to the dictionary. The member function <CODE>replace</CODE> searches for a definition whose first component is equal to the result of converting <CODE>key</CODE> to lower case. If it finds such a definition, it assigns the replacement text to <CODE>key</CODE>, adjusting the case of the first character to match the case of the first character of <CODE>key</CODE>. Otherwise, it does nothing.62 The member function <CODE>add</CODE> converts <CODE>key</CODE> to lower case and adds the pair <CODE>key</CODE>, <CODE>value</CODE> to the dictionary. The member function <CODE>replace</CODE> searches for a definition whose first component is equal to the result of converting <CODE>key</CODE> to lower case. If it finds such a definition, it assigns the replacement text to <CODE>key</CODE>, adjusting the case of the first character to match the case of the first character of <CODE>key</CODE>. Otherwise, it does nothing. 63 63 </P> 64 64 65 65 <A NAME="dictionary_stdio_filter"></A> -
libs/iostreams/doc/tutorial/shell_comments_filters.html
217 217 <SPAN CLASS="keyword">template</SPAN><<SPAN CLASS="keyword">typename</SPAN> Sink> 218 218 <SPAN CLASS='keyword'>bool</SPAN> put(Sink& dest, <SPAN CLASS='keyword'>int</SPAN> c) 219 219 { 220 <SPAN CLASS='comment'>// Attempt to consume the given character of unfil itered</SPAN>220 <SPAN CLASS='comment'>// Attempt to consume the given character of unfiltered</SPAN> 221 221 <SPAN CLASS='comment'>// data, writing filtered data to dest as appropriate. </SPAN> 222 222 <SPAN CLASS='comment'>// Return true if the character was successfully consumed.</SPAN> 223 223 } -
libs/iostreams/doc/tutorial/filter_usage.html
52 52 </P> 53 53 54 54 <P> 55 Now suppose you want to recove d the original data. If you have appropriate InputFilters <CODE>decompressor</CODE> and <CODE>base64_decoder</CODE>, you can accomplish this as follows as follows:<A CLASS='footnote_ref' NAME='note_2_ref' HREF="#note_2"><SUP>[2]</SUP></A>55 Now suppose you want to recover the original data. If you have appropriate InputFilters <CODE>decompressor</CODE> and <CODE>base64_decoder</CODE>, you can accomplish this as follows:<A CLASS='footnote_ref' NAME='note_2_ref' HREF="#note_2"><SUP>[2]</SUP></A> 56 56 </P> 57 57 58 58 <PRE CLASS="broken_ie"> -
libs/iostreams/doc/tutorial/writing_filters.html
27 27 <A NAME="filter_overview"></A> 28 28 <H2>2.2.1. Overview: InputFilters, OutputFilters and Filter Helpers</H2> 29 29 30 <P>Filters are used to modif iedcharacter 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.</P>30 <P>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.</P> 31 31 32 32 33 33 <A NAME="input_filters_and_output_filters"></A> 34 34 <H4>InputFilters and OutputFilters</H4> 35 35 36 <P>The Iostreams library supports two basic categories of Filters <A HREF="../concepts/input_filter.html">InputFilters</A> and <A HREF="../concepts/output_filter.html">OutputFilters</A>. InputFilters represent a “pull” model of filtering: a source of unfilitered data is provided — represented as a <A HREF="../concepts/source.html">Source</A> — and the Filter is expected to generate a certain numbercharacters of the filtered sequence. The filtered sequence is generated incrementally, meaning that to filter a given character sequence the Filter typically must be invoked several times. <A HREF="../concepts/output_filter.html">OutputFilters</A> represent a “push” model of filtering: a sequence of unfiltered characters and a <A HREF="../concepts/sink.html">Sink</A> are provided, and the Filter is expected to filter the characters and write them to the Sink. Like InputFilters, OutputFilters also process data incrementally.</P>36 <P>The Iostreams library supports two basic categories of Filters, <A HREF="../concepts/input_filter.html">InputFilters</A> and <A HREF="../concepts/output_filter.html">OutputFilters</A>. InputFilters represent a “pull” model of filtering: a source of unfiltered data is provided — represented as a <A HREF="../concepts/source.html">Source</A> — and the Filter is expected to generate a certain number of characters of the filtered sequence. The filtered sequence is generated incrementally, meaning that to filter a given character sequence the Filter typically must be invoked several times. <A HREF="../concepts/output_filter.html">OutputFilters</A> represent a “push” model of filtering: a sequence of unfiltered characters and a <A HREF="../concepts/sink.html">Sink</A> are provided, and the Filter is expected to filter the characters and write them to the Sink. Like InputFilters, OutputFilters also process data incrementally.</P> 37 37 38 <P>The simplest InputFilters and OutputFilters process characters one at a time. This type of Filter is easy to write, but is less efficient than Filters that process several characters at a time. Filters which process several characters at a time are called <A HREF="../concepts/multi_character.html">Multi-Character</A> fi ters.</P>38 <P>The simplest InputFilters and OutputFilters process characters one at a time. This type of Filter is easy to write, but is less efficient than Filters that process several characters at a time. Filters which process several characters at a time are called <A HREF="../concepts/multi_character.html">Multi-Character</A> filters.</P> 39 39 40 40 <A NAME="filter_helpers"></A> 41 41 <H4>Filter Helpers</H4> … … 43 43 <P>The Iostreams library provides several utilities to make Filter writing easier:</P> 44 44 <UL> 45 45 <LI> 46 <A HREF="../classes/aggregate.html"><CODE>aggregate_filter</CODE></A> allows a programmer to define a Filter by reading unfil itered data from one <CODE>std::vector</CODE> and writing filtered data to another <CODE>std::vector</CODE>.46 <A HREF="../classes/aggregate.html"><CODE>aggregate_filter</CODE></A> allows a programmer to define a Filter by reading unfiltered data from one <CODE>std::vector</CODE> and writing filtered data to another <CODE>std::vector</CODE>. 47 47 </LI> 48 48 <LI> 49 <A HREF="../classes/stdio_filter.html"><CODE>stdio_filter</CODE></A> allows a programmer to define a Filter by reading unfil itered data from standard input and writing filtered data to standard output.49 <A HREF="../classes/stdio_filter.html"><CODE>stdio_filter</CODE></A> allows a programmer to define a Filter by reading unfiltered data from standard input and writing filtered data to standard output. 50 50 </LI> 51 51 <LI> 52 <A HREF="../classes/symmetric_filter.html"><CODE>symmetric_filter</CODE></A> allows a programmer to define a Filter by reading unfil itered data from one array and writing filtered data to another array.52 <A HREF="../classes/symmetric_filter.html"><CODE>symmetric_filter</CODE></A> allows a programmer to define a Filter by reading unfiltered data from one array and writing filtered data to another array. 53 53 </LI> 54 54 <LI> 55 55 <A HREF="finite_state_filters.html"><CODE>finite_state_filter</CODE></A> allows a programmer to define a Filter as a finite state machine. This component is included with the example filters; it is not currently an official part of the library. … … 60 60 <H4>Selecting a Filter Concept</H4> 61 61 62 62 <P> 63 Suppose you need to write a Filter to perform a given filtering task. How do you decide whether to write an <A HREF="../concepts/input_filter.html">InputFilter s</A> or <A HREF="../concepts/output_filter.html">OutputFilters</A>, or to use one of the Filter helpers? The first two Filter helpers mentioned above, <A HREF="../classes/aggregate.html"><CODE>aggregate_filter</CODE></A> and <A HREF="../classes/stdio_filter.html"><CODE>stdio_filter</CODE></A>, have high-memory usage and only work with character sequences that have a well-defined end. They allow filtering algorithms to be expressed in a very straightforward way, however, and so provide a good introduction to filtering. The third Filter helper, <A HREF="../classes/symmetric_filter.html"><CODE>symmetric_filter</CODE></A>, is useful for defining filter based on C-language API such as zlib, libbz2 or OpenSSL. If none of the Filter helpers are appropriate, you should generally write an InputFilter if you plan to use the filter for reading and an OutputFilter if you plan to use it for writing. In some cases, however, it is much easier to express an algorithm as an InputFilter than as an OutputFilter, or <I>vice versa</I>. In such cases, you can write the filter whichever way is easier, and use the class template <A HREF="../functions/invert.html#inverse"><CODE>inverse</CODE></A> or the function template <A HREF="../functions/invert.html"><CODE>invert</CODE></A> to turn an InputFilter into an OutputFilter or <I>vice versa</I>.63 Suppose you need to write a Filter to perform a given filtering task. How do you decide whether to write an <A HREF="../concepts/input_filter.html">InputFilter</A> or <A HREF="../concepts/output_filter.html">OutputFilter</A>, or to use one of the Filter helpers? The first two Filter helpers mentioned above, <A HREF="../classes/aggregate.html"><CODE>aggregate_filter</CODE></A> and <A HREF="../classes/stdio_filter.html"><CODE>stdio_filter</CODE></A>, have high-memory usage and only work with character sequences that have a well-defined end. They allow filtering algorithms to be expressed in a very straightforward way, however, and so provide a good introduction to filtering. The third Filter helper, <A HREF="../classes/symmetric_filter.html"><CODE>symmetric_filter</CODE></A>, is useful for defining filter based on C-language API such as zlib, libbz2 or OpenSSL. If none of the Filter helpers are appropriate, you should generally write an InputFilter if you plan to use the filter for reading and an OutputFilter if you plan to use it for writing. In some cases, however, it is much easier to express an algorithm as an InputFilter than as an OutputFilter, or <I>vice versa</I>. In such cases, you can write the filter whichever way is easier, and use the class template <A HREF="../functions/invert.html#inverse"><CODE>inverse</CODE></A> or the function template <A HREF="../functions/invert.html"><CODE>invert</CODE></A> to turn an InputFilter into an OutputFilter or <I>vice versa</I>. 64 64 </P> 65 65 66 66 <P>