#ifndef OSMIUM_UTIL_VERBOSE_OUTPUT_HPP #define OSMIUM_UTIL_VERBOSE_OUTPUT_HPP /* This file is part of Osmium (https://osmcode.org/libosmium). Copyright 2013-2022 Jochen Topf and others (see README). Boost Software License - Version 1.0 - August 17th, 2003 Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #include #include #include #include #include namespace osmium { /** * @brief Helpful utility classes and functions not strictly OSM related */ inline namespace util { /** * Osmium programs often run for a long time because of the amount of * OSM data processed. This class helps with keeping the user up to * date by offering an easy way for programs to optionally output * verbose information about what's going on. * * Use an object of this class instead of std::cerr as an output * stream. Nothing is actually written if the object is not set to * verbose mode. If it is set to verbose mode, each line is prepended * with the running time, ie the time since the VerboseOutput object * was created. */ class VerboseOutput { /// all time output will be relative to this start time std::time_t m_start; /// is verbose mode enabled? bool m_verbose; /// a newline was written, start next output with runtime bool m_newline = true; /** * If we remember that a newline was written as the last thing * write out the time elapsed and reset the newline flag. */ void start_line() { if (m_newline) { const std::time_t elapsed = runtime(); const char old_fill = std::cerr.fill(); std::cerr << '[' << std::setw(2) << (elapsed / 60) << ':' << std::setw(2) << std::setfill('0') << (elapsed % 60) << "] "; std::cerr.fill(old_fill); m_newline = false; } } public: explicit VerboseOutput(bool verbose = false) noexcept : m_start(std::time(nullptr)), m_verbose(verbose) { } std::time_t runtime() const noexcept { return std::time(nullptr) - m_start; } /// Get "verbose" setting. bool verbose() const noexcept { return m_verbose; } /// Set "verbose" setting. void verbose(bool verbose) noexcept { m_verbose = verbose; } template void print(const T& value) { if (m_verbose) { start_line(); std::cerr << value; // check if there was a newline a the end and remember that std::ostringstream output_buffer; output_buffer << value; if (!output_buffer.str().empty() && output_buffer.str().back() == '\n') { m_newline = true; } } } }; // class VerboseOutput template inline VerboseOutput& operator<<(VerboseOutput& verbose_output, const T& value) { verbose_output.print(value); return verbose_output; } } // namespace util } // namespace osmium #endif // OSMIUM_UTIL_VERBOSE_OUTPUT_HPP