mirror of
				https://github.com/saitohirga/WSJT-X.git
				synced 2025-11-03 13:30:52 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			74 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			74 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
.. Copyright David Abrahams 2006. Distributed under the Boost
 | 
						|
.. Software License, Version 1.0. (See accompanying
 | 
						|
.. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
 | 
						|
 | 
						|
Example
 | 
						|
.......
 | 
						|
 | 
						|
This example prints an array of characters, using
 | 
						|
``indirect_iterator`` to access the array of characters through an
 | 
						|
array of pointers. Next ``indirect_iterator`` is used with the
 | 
						|
``transform`` algorithm to copy the characters (incremented by one) to
 | 
						|
another array. A constant indirect iterator is used for the source and
 | 
						|
a mutable indirect iterator is used for the destination. The last part
 | 
						|
of the example prints the original array of characters, but this time
 | 
						|
using the ``make_indirect_iterator`` helper function.
 | 
						|
 | 
						|
 | 
						|
::
 | 
						|
 | 
						|
    char characters[] = "abcdefg";
 | 
						|
    const int N = sizeof(characters)/sizeof(char) - 1; // -1 since characters has a null char
 | 
						|
    char* pointers_to_chars[N];                        // at the end.
 | 
						|
    for (int i = 0; i < N; ++i)
 | 
						|
      pointers_to_chars[i] = &characters[i];
 | 
						|
 | 
						|
    // Example of using indirect_iterator
 | 
						|
 | 
						|
    boost::indirect_iterator<char**, char>
 | 
						|
      indirect_first(pointers_to_chars), indirect_last(pointers_to_chars + N);
 | 
						|
 | 
						|
    std::copy(indirect_first, indirect_last, std::ostream_iterator<char>(std::cout, ","));
 | 
						|
    std::cout << std::endl;
 | 
						|
 | 
						|
 | 
						|
    // Example of making mutable and constant indirect iterators
 | 
						|
 | 
						|
    char mutable_characters[N];
 | 
						|
    char* pointers_to_mutable_chars[N];
 | 
						|
    for (int j = 0; j < N; ++j)
 | 
						|
      pointers_to_mutable_chars[j] = &mutable_characters[j];
 | 
						|
 | 
						|
    boost::indirect_iterator<char* const*> mutable_indirect_first(pointers_to_mutable_chars),
 | 
						|
      mutable_indirect_last(pointers_to_mutable_chars + N);
 | 
						|
    boost::indirect_iterator<char* const*, char const> const_indirect_first(pointers_to_chars),
 | 
						|
      const_indirect_last(pointers_to_chars + N);
 | 
						|
 | 
						|
    std::transform(const_indirect_first, const_indirect_last,
 | 
						|
		   mutable_indirect_first, std::bind1st(std::plus<char>(), 1));
 | 
						|
 | 
						|
    std::copy(mutable_indirect_first, mutable_indirect_last,
 | 
						|
	      std::ostream_iterator<char>(std::cout, ","));
 | 
						|
    std::cout << std::endl;
 | 
						|
 | 
						|
 | 
						|
    // Example of using make_indirect_iterator()
 | 
						|
 | 
						|
    std::copy(boost::make_indirect_iterator(pointers_to_chars), 
 | 
						|
	      boost::make_indirect_iterator(pointers_to_chars + N),
 | 
						|
	      std::ostream_iterator<char>(std::cout, ","));
 | 
						|
    std::cout << std::endl;
 | 
						|
 | 
						|
 | 
						|
The output is::
 | 
						|
 | 
						|
    a,b,c,d,e,f,g,
 | 
						|
    b,c,d,e,f,g,h,
 | 
						|
    a,b,c,d,e,f,g,
 | 
						|
 | 
						|
 | 
						|
The source code for this example can be found `here`__.
 | 
						|
 | 
						|
__ ../example/indirect_iterator_example.cpp
 | 
						|
 |