tap()

template<typename Executor , ComputeData DataType>

template<typename Func >
requires std::invocable<Func, DataType&>

FluentExecutor & MayaFlux::Yantra::FluentExecutor< Executor, DataType >::tap ( Func &&  func )

inline

Apply a side-effect function without changing data or type.

func receives a mutable reference to the raw DataType. Useful for logging, validation, or in-place mutation that does not change type. Does not affect the Datum wrapper or container.

Template Parameters

Func	Callable type: (DataType&) -> void

Parameters

func	Function to apply for side effects

Returns

Reference to this executor for continued chaining

Definition at line 265 of file OperationChain.hpp.

    {
        if (!m_successful) {
            error<std::runtime_error>(
                Journal::Component::Yantra, Journal::Context::ComputeMatrix,
                std::source_location::current(),
                "Cannot continue chain after failed operation in tap");
        }
 
        try {
            std::forward<Func>(func)(m_data.data);
            m_operation_history.emplace_back("tap");
            return *this;
        } catch (const std::exception& e) {
            m_successful = false;
            record_error(std::string("Tap function failed: ") + e.what());
            error_rethrow(
                Journal::Component::Yantra, Journal::Context::ComputeMatrix,
                std::source_location::current(),
                "Exception in tap function: " + std::string(e.what()));
        }
    }