File indexing completed on 2024-04-28 16:53:07

 /*
  *   SPDX-FileCopyrightText: 2016 Ivan Cukic <ivan.cukic(at)kde.org>
  *
  *   SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
  */
 
 #ifndef ASYNQT_BASE_TRANSFORM_H
 #define ASYNQT_BASE_TRANSFORM_H
 
 #include <QFuture>
 #include <QFutureWatcher>
 
 #include <memory>
 #include <type_traits>
 
 #include "../private/operations/transform_p.h"
 
 namespace AsynQt
 {
 /**
  * This method applies the specified transformation function to
  * the value stored in the given future. Since the value might not
  * yet be present, it returns a future that will contain the
  * transformed value as soon as the original future is finished.
  *
  * If the original future is canceled, the transformation function
  * will not be invoked, and the resulting future will also be canceled.
  *
  * Example:
  *
  * <code>
  *     QFuture<int> answer = meaningOfLife()
  *     // answer will eventually contain 42
  *
  *     QFuture<QString> text = transform(answer, toText)
  *     // text will eventually contain the result of toText(42)
  * </code>
  *
  * @arg future the future to transform
  * @arg transformation unary function to apply to the value in the future
  * @returns a future that will contain the transformed value
  */
 template<typename _In, typename _Transformation>
 QFuture<typename detail::TransformFutureInterface<_In, _Transformation>::result_type> transform(const QFuture<_In> &future, _Transformation &&transormation)
 {
     using namespace detail;
     return transform_impl(future, std::forward<_Transformation>(transormation));
 }
 
 namespace operators
 {
 template<typename _Transformation>
 detail::operators::TransformationModifier<_Transformation> transform(_Transformation &&transormation)
 {
     return detail::operators::TransformationModifier<_Transformation>(std::forward<_Transformation>(transormation));
 }
 
 } // namespace operators
 
 } // namespace AsynQt
 
 #endif // ASYNQT_BASE_TRANSFORM_H