Files
boost_algorithm/include/boost/algorithm/transform_if.hpp
Jesse Williamson e9c9685fe9 Documentation updates and new Doxyfile; new unit test and minor fix;
moved minmax_macro; new example.


[SVN r52655]
2009-04-28 19:57:54 +00:00

96 lines
4.2 KiB
C++

/*
Copyright (C) 2008 Jesse Williamson
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)
*/
#ifndef BOOST_ALGORITHM_SEQUENCE_TRANSFORM_IF_HPP
#define BOOST_ALGORITHM_SEQUENCE_TRANSFORM_IF_HPP
#include <boost/range.hpp>
/// \file transform_if.hpp
/// \brief Apply operations across ranges when a predicate is true, storing returned values.
/// \author Jesse Williamson
namespace boost { namespace algorithm { namespace sequence {
/// \fn transform_if ( InputIterator first, InputIterator last, OutputIterator result, UnaryFunction op, UnaryPredicate pred )
/// \brief Applies op to all elements in [first, last] for which pred is true, storing each returned value in the range
/// beginning at result.
///
/// \param first The start of the input sequence.
/// \param last One past the end of the input sequence.
/// \param result The start of the output sequence.
/// \param op Unary operation to apply when pred is true.
/// \param pred Unary condition predicate.
///
template <class InputIterator, class OutputIterator, class UnaryFunction, class UnaryPredicate>
OutputIterator transform_if(InputIterator first, InputIterator last, OutputIterator result, UnaryFunction op, UnaryPredicate pred)
{
for( ; first != last; ++first, ++result )
if( pred( *first ) )
*result = op( *first );
return result;
}
/// \fn transform_if ( ForwardReadableRange& R, OutputIterator result, UnaryFunction op, UnaryPredicate pred )
/// \brief Applies op to all elements in [first, last] for which pred is true, storing each returned value in the range
/// beginning at result.
///
/// \param R A forward readable Boost range input sequence.
/// \param result The start of the output sequence.
/// \param op Unary operation to apply when pred is true.
/// \param pred Unary condition predicate.
///
template <class ForwardReadableRange, class OutputIterator, class UnaryFunction, class UnaryPredicate>
OutputIterator transform_if(ForwardReadableRange& R, OutputIterator result, UnaryFunction op, UnaryPredicate pred)
{
return transform_if( boost::begin(R), boost::end(R), result, op, pred );
}
/// \fn transform_if ( InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, OutputIterator result, BinaryFunction op, BinaryPredicate pred )
/// \brief Applies op to all elements in [first, last] for which pred is true, storing each returned value in the range
/// beginning at result.
///
/// \param first1 The start of the first input sequence.
/// \param last1 One past the end of the first input sequence.
/// \param first2 The start of the second input sequence.
/// \param result The start of the output sequence.
/// \param op Binary operation to apply when pred is true.
/// \param pred Binary condition predicate.
///
template <class InputIterator1, class InputIterator2, class OutputIterator, class BinaryFunction, class BinaryPredicate>
OutputIterator transform_if(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, OutputIterator result, BinaryFunction op, BinaryPredicate pred)
{
for ( ; first1 != last1; ++first1, ++first2, ++result )
if ( pred( *first1, *first2 ) )
*result = op( *first1, *first2 );
}
/// \fn transform_if ( ForwardReadableRange& R, InputIterator2 first2, OutputIterator result, BinaryFunction op, BinaryPredicate pred )
/// \brief Applies op to all elements in [first, last] for which pred is true, storing each returned value in the range
/// beginning at result.
///
/// \param R A forward-readable Boost range input sequence.
/// \param first2 The start of the second input sequence.
/// \param result The start of the output sequence.
/// \param op Binary operation to apply when pred is true.
/// \param pred Binary condition predicate.
///
template <class ForwardReadableRange, class InputIterator2, class OutputIterator, class BinaryFunction, class BinaryPredicate>
OutputIterator transform_if(ForwardReadableRange& R, InputIterator2 first2, OutputIterator result, BinaryFunction op, BinaryPredicate pred)
{
return transform_if( boost::begin(R), boost::end(R), first2, result, op, pred );
}
}}} // namespace boost::algorithm::sequence
#endif