Boost-Commit :

Date view	Thread view	Subject view	Author view

From: nesotto_at_[hidden]
Date: 2007-11-17 15:22:21

Next message: nesotto_at_[hidden]: "[Boost-commit] svn:boost r41177 - trunk/boost/range/detail"
Previous message: nesotto_at_[hidden]: "[Boost-commit] svn:boost r41175 - trunk/boost/range"

Author: nesotto
Date: 2007-11-17 15:22:20 EST (Sat, 17 Nov 2007)
New Revision: 41176
URL: http://svn.boost.org/trac/boost/changeset/41176

Log:
last updates
Text files modified:
   trunk/libs/range/doc/boost_range.html | 24 +++++++++++++++
   trunk/libs/range/doc/headers.html | 23 ++++++---------
   trunk/libs/range/doc/utility_class.html | 58 +++++++++++++++++++++------------------
   3 files changed, 63 insertions(+), 42 deletions(-)

Modified: trunk/libs/range/doc/boost_range.html
==============================================================================
--- trunk/libs/range/doc/boost_range.html (original)
+++ trunk/libs/range/doc/boost_range.html 2007-11-17 15:22:20 EST (Sat, 17 Nov 2007)
@@ -157,7 +157,7 @@
 //

 template< class T >
- typename range_size<T>::type
+ typename range_difference<T>::type
 size( const T& r );

 //
@@ -471,12 +471,34 @@
 <td>linear time for pointers to a string, constant time
 otherwise</td>
 </tr>
+ <tr>
+ <a name="as_array"></a>
+ <td><code>as_array(x)</code></td>
+ <td><code>iterator_range<X></code> </td>
+ <td>
+ <code>[boost::begin(x),boost::end(x))</code>
+
+
+
+
+ </td>
+ <td>constant time otherwise</td>
+ </tr>
+
 </table>
 
 
 The special <code>const_</code>-named functions are useful when you
 want to document clearly that your code is read-only.
 
+ 
+ <code>as_literal()</code> can be used internally in string
+ algorithm librararies to such that arrays of characters are
+ handled correctly.
+ 
+ 
+ <code>as_array()</code> can be used with string algorithm libraries to make it clear that arrays of characters are handled like an array and not like a string.
+ 
 Notice that the above functions should always be called with
 qualification (<code>boost::</code>) to prevent unintended
 Argument Dependent Lookup (ADL).

Modified: trunk/libs/range/doc/headers.html
==============================================================================
--- trunk/libs/range/doc/headers.html (original)
+++ trunk/libs/range/doc/headers.html 2007-11-17 15:22:20 EST (Sat, 17 Nov 2007)
@@ -50,7 +50,7 @@
>range_iterator</a></td>
 <td>Single Pass Range </td>
 </tr>
- <tr >
+ <tr >
 <td ><code ><boost/range/mutable_iterator.hpp></code></td>
 <td ><a href="boost_range.html#range_mutable_iterator"
>range_mutable_iterator</a></td>
@@ -69,20 +69,15 @@
 <td>Forward Range </td>
 </tr>
 <tr >
- <td ><code ><boost/range/size_type.hpp></code></td>
- <td >range_size</td>
- <td>Forward Range </td>
- </tr>
- <tr >
 <td ><code ><boost/range/pointer.hpp></code></td>
 <td ><a href="boost_range.html#range_pointer"
- >range_pointer</a></td>
+ >range_pointer</a></td>
 <td>- </td>
 </tr>
- <tr >
+ <tr >
 <td ><code ><boost/range/category.hpp></code></td>
 <td ><a href="boost_range.html#range_category"
- >range_category</a></td>
+ >range_category</a></td>
 <td>- </td>
 </tr>

@@ -112,7 +107,7 @@
 <td >empty</td>
 <td>Single Pass Range </td>
 </tr>
- <tr >
+ <tr >
 <td ><code ><boost/range/distance.hpp></code></td>
 <td >distance</td>
 <td>Forward Range </td>
@@ -121,7 +116,7 @@
 <td ><code ><boost/range/size.hpp></code></td>
 <td >size</td>
 <td>Random Access Range
- </td>
+ </td>
 </tr>
 <tr >
 <td ><code ><boost/range/rbegin.hpp></code></td>
@@ -139,14 +134,14 @@
 </td>
 <td>Bidirectional Range </td>
 </tr>
- <tr >
+ <tr >
 <td ><code ><boost/range/as_array.hpp></code></td>
 <td >
 <a href="boost_range.html#as_array" >as_array</a>
 </td>
 <td>-</td>
 </tr>
- <tr >
+ <tr >
 <td ><code ><boost/range/as_literal.hpp></code></td>
 <td >
 <a href="boost_range.html#as_literal" >as_literal</a>
@@ -178,7 +173,7 @@

 <hr>
 
- (C) Copyright Thorsten Ottosen 2003-2004
+ (C) Copyright Thorsten Ottosen 2003-2007

Modified: trunk/libs/range/doc/utility_class.html
==============================================================================
--- trunk/libs/range/doc/utility_class.html (original)
+++ trunk/libs/range/doc/utility_class.html 2007-11-17 15:22:20 EST (Sat, 17 Nov 2007)
@@ -79,9 +79,10 @@
 class iterator_range
 {
 public: // Forward Range types
- typedef ForwardTraversalIterator iterator;
- typedef ForwardTraversalIterator const_iterator;
-
+ typedef ForwardTraversalIterator iterator;
+ typedef ForwardTraversalIterator const_iterator;
+ typedef iterator_difference<iterator>::type difference_type;
+
 public: // construction, assignment
 template< class ForwardTraversalIterator2 >
 iterator_range( ForwardTraversalIterator2 Begin, ForwardTraversalIterator2 End );
@@ -99,23 +100,24 @@
 iterator_range& operator=( const ForwardRange& r );

 public: // Forward Range functions
- iterator begin() const;
- iterator end() const;
- size_type size() const;
- bool empty() const;
+ iterator begin() const;
+ iterator end() const;
+ difference_type size() const;
+ bool empty() const;

 public: // convenience
- operator unspecified_bool_type() const;
- bool operator unspecified_bool_type() const;
+ bool equal( const iterator_range& ) ( const iterator_range& ) const;
- referencefront() const;
- reference back() const;
+ reference front() const;
+ reference back() const;
+ iterator_range& advance_begin( difference_type n );
+ iterator_range& advance_end( difference_type n );
 // for Random Access Range only: 
- value_type& operator[]( size_type at ) const;
- value_typecial>& operator()( size_type at ) const;
+ reference operator[]( difference_type at ) const;
+ value_type operator()( difference_type at ) const;
 };

 // stream output
@@ -168,11 +170,11 @@
 ForwardTraversalIterator End );

 template< class ForwardRange >
- iterator_range< typename iterator<ForwardRange>::type >
+ iterator_range< typename range_iterator<ForwardRange>::type >
 make_iterator_range( ForwardRange& r );

 template< class ForwardRange >
- iterator_range< typename const_iterator<ForwardRange>::type >
+ iterator_range< typename range_iterator<const ForwardRange>::type >
 make_iterator_range( const ForwardRange& r );
 
 template< class Range >
@@ -182,7 +184,7 @@
 typename range_difference<Range>::type advance_end );
 
 template< class Range >
- iterator_range< typename range_const_iterator<Range>::type >
+ iterator_range< typename range_iterator<const Range>::type >
 make_iterator_range( const Range& r,
 typename range_difference<Range>::type advance_begin,
 typename range_difference<Range>::type advance_end );
@@ -286,12 +288,14 @@
namespace boost
{
 template< class ForwardRange >
- class sub_range : public iterator_range< typename range_result_iterator<ForwardRange>::type >
+ class sub_range : public iterator_range< typename range_iterator<ForwardRange>::type >
 {
 public: 
- typedef typename range_result_iterator<ForwardRange<spanclass=special>>::type iterator;
- typedef typename range_const_iterator<ForwardRange>::type const_iterator;
+ typedef typename range_iterator<ForwardRange<spanclass=special>>::type iterator;
+ typedef typename range_iterator<const ForwardRange>::type const_iterator;
+ typedef typename iterator_difference<iterator>::type difference_type;

+
 public: // construction, assignment
 template< class ForwardTraversalIterator >
 sub_range( ForwardTraversalIterator Begin, ForwardTraversalIterator End );
@@ -320,8 +324,8 @@
 value_type& back();
 const value_type& back() const;
 // for Random Access Range only: 
- value_type& operator[]( size_type at );
- const value_type& operator[]( size_type at ) const;
+ value_type& operator[]( difference_type at );
+ const value_type& operator[]( difference_type at ) const;

 public:
 // rest of interface inherited from <a href=#iter_range><code>iterator_range</code></a>
@@ -339,15 +343,15 @@
 from this algorithm. Here is an example of how we can do it with and without
<code>sub_range</code>
 <pre>
- std::string str("hello");
- iterator_range<std::string::iterator> ir = find_first( str, "ll" );
- sub_range<std::string> sub = find_first( str, "ll" );
+ std::string str("hello");
+ iterator_range<std::string::iterator> ir = find_first( str, as_literal("ll") );
+ sub_range<std::string> sub = find_first( str, as_literal("ll") );
</pre>
 

<hr>
 
- (C) Copyright Thorsten Ottosen 2003-2004
+ (C) Copyright Thorsten Ottosen 2003-2007

Next message: nesotto_at_[hidden]: "[Boost-commit] svn:boost r41177 - trunk/boost/range/detail"
Previous message: nesotto_at_[hidden]: "[Boost-commit] svn:boost r41175 - trunk/boost/range"

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk