LogRelationTimer.h

Go to the documentation of this file.

/*
 * Souffle - A Datalog Compiler
 * Copyright (c) 2017, The Souffle Developers. All rights reserved
 * Licensed under the Universal Permissive License v 1.0 as shown at:
 * - https://opensource.org/licenses/UPL
 * - <souffle root>/licenses/SOUFFLE-UPL.txt
 */
 
/************************************************************************
 *
 * @file LogRelationTimer.h
 *
 ***********************************************************************/
 
#pragma once
 
#include "ram/AbstractLog.h"
#include "ram/Node.h"
#include "ram/Relation.h"
#include "ram/RelationStatement.h"
#include "ram/Statement.h"
#include "ram/utility/NodeMapper.h"
#include "souffle/utility/MiscUtil.h"
#include "souffle/utility/StreamUtil.h"
#include "souffle/utility/StringUtil.h"
#include <memory>
#include <ostream>
#include <string>
#include <utility>
#include <vector>
 
namespace souffle::ram {
 
/**
 * @class LogRelationTimer
 * @brief Execution time logger for a statement
 *
 * Logs the execution time of a statement. Before and after
 * the execution of the logging statement the wall-clock time
 * is taken to compute the time duration for the statement.
 * Duration and logging message is printed after the execution
 * of the statement.
 *
 * For example:
 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * START_TIMER ON A "file.dl [8:1-8:8]\;"
 *   ...
 * END_TIMER
 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 */
class LogRelationTimer : public RelationStatement, public AbstractLog {
public:
    LogRelationTimer(Own<Statement> stmt, std::string msg, std::string relRef)
            : RelationStatement(std::move(relRef)), AbstractLog(std::move(stmt), std::move(msg)) {}
 
    std::vector<const Node*> getChildNodes() const override {
        std::vector<const Node*> res = RelationStatement::getChildNodes();
        res.push_back(AbstractLog::getChildNodes().at(0));
        return res;
    }
 
    LogRelationTimer* clone() const override {
        return new LogRelationTimer(souffle::clone(statement), message, relation);
    }
 
    void apply(const NodeMapper& map) override {
        RelationStatement::apply(map);
        AbstractLog::apply(map);
    }
 
protected:
    void print(std::ostream& os, int tabpos) const override {
        os << times(" ", tabpos) << "START_TIMER ON " << relation << " \"" << stringify(message) << "\""
           << std::endl;
        Statement::print(statement.get(), os, tabpos + 1);
        os << times(" ", tabpos) << "END_TIMER" << std::endl;
    }
};
 
}  // namespace souffle::ram