/************************************************************************* ** utility.hpp ** ** ** ** This file is part of dvisvgm -- a fast DVI to SVG converter ** ** Copyright (C) 2005-2024 Martin Gieseking ** ** ** ** This program is free software; you can redistribute it and/or ** ** modify it under the terms of the GNU General Public License as ** ** published by the Free Software Foundation; either version 3 of ** ** the License, or (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, but ** ** WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program; if not, see . ** *************************************************************************/ #ifndef UTILITY_HPP #define UTILITY_HPP #ifdef HAVE_CONFIG_H #include #endif #include #include #include #include #include #include #include namespace math { constexpr const double PI = 3.141592653589793238462643383279502884; constexpr const double HALF_PI = 1.570796326794896619231321691639751442; constexpr const double TWO_PI = 6.283185307179586476925286766559005768; constexpr const double SQRT2 = 1.414213562373095048801688724209698079; inline double deg2rad (double deg) {return PI*deg/180.0;} inline double rad2deg (double rad) {return 180.0*rad/PI;} double normalize_angle (double angle, double mod); double normalize_0_2pi (double rad); std::vector svd (const double (&m)[2][2]); double integral (double t0, double t1, int n, const std::function &f); /** Signum function (returns x/abs(x) if x != 0, and 0 otherwise). */ template inline int sgn (T x) {return (x > T(0)) - (x < T(0));} } // namespace math namespace util { template std::string tohex (T val) { std::ostringstream oss; oss << std::hex << val; return oss.str(); } std::string trim (const std::string &str, const char *ws=" \t\n\r\f"); std::string normalize_space (std::string str, const char *ws=" \t\n\r\f"); std::string tolower (const std::string &str); std::string replace (std::string str, const std::string &find, const std::string &repl); std::string to_string (double val); std::string mimetype (const std::string &fname); std::vector split (const std::string &str, const std::string &sep, bool allowEmptyResult=false); int ilog10 (int n); bool read_double (std::istream &is, double &value); std::string read_file_contents (const std::string &fname); void write_file_contents (const std::string &fname, std::string::iterator start, std::string::iterator end); /** Returns a sequence of bytes of a given integral value. * @param[in] val get bytes of this value * @param[in] n number of bytes to extract (from LSB to MSB), all if n == 0 * @return vector of bytes in big-endian order */ template std::vector bytes (T val, int n=0) { if (n <= 0) n = sizeof(T); std::vector ret(n); for (int i=0; i < n; i++) { ret[n-i-1] = val & 0xff; val >>= 8; } return ret; } /** Encodes the bytes in the half-open range [first,last) to Base64 and writes * the result to the range starting at 'dest'. * @param[in] first initial position of the range to be encoded * @param[in] last final position of the range to be encoded * @param[in] dest first position of the destination range * @param[in] wrap if > 0, add a newline after the given number of characters written */ template void base64_copy (InputIterator first, InputIterator last, OutputIterator dest, int wrap=0) { static const char *base64_chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; int count=0; while (first != last) { int padding = 0; unsigned char c0 = *first++, c1=0, c2=0; if (first == last) padding = 2; else { c1 = *first++; if (first == last) padding = 1; else c2 = *first++; } uint32_t n = (c0 << 16) | (c1 << 8) | c2; for (int i=0; i <= 3-padding; i++) { if (wrap > 0 && ++count > wrap) { count = 1; *dest++ = '\n'; } *dest++ = base64_chars[(n >> 18) & 0x3f]; n <<= 6; } while (padding--) { if (wrap > 0 && ++count > wrap) { count = 1; *dest++ = '\n'; } *dest++ = '='; } } } inline void base64_copy (std::istream &is, std::ostream &os, int wrap=0) { base64_copy(std::istreambuf_iterator(is), std::istreambuf_iterator(), std::ostreambuf_iterator(os), wrap); } /** Simple implementation mimicking std::make_unique introduced in C++14. * Constructs an object of class T on the heap and returns a unique_ptr to it. * @param[in] args arguments forwarded to an constructor of T */ template inline std::unique_ptr make_unique (Args&&... args) { return std::unique_ptr(new T(std::forward(args)...)); } /** Simple implementation mimicking array variant of std::make_unique introduced in C++14. * Constructs an array of class T on the heap and returns a unique_ptr(size) to it. * @param[in] size size of array */ template inline std::unique_ptr make_unique (std::size_t size) { return std::unique_ptr(new typename std::remove_extent::type[size]()); } template inline std::unique_ptr static_unique_ptr_cast (std::unique_ptr &&old){ return std::unique_ptr{static_cast(old.release())}; } #ifdef HAVE___BUILTIN_CLZ template typename std::enable_if::type count_leading_zeros (T val) { return val == 0 ? 8*sizeof(T) : __builtin_clz(val) - 8*(sizeof(unsigned int)-sizeof(T)); } template typename std::enable_if::type count_leading_zeros (T val) { return val == 0 ? 8*sizeof(T) : __builtin_clzl(val); } template typename std::enable_if::type count_leading_zeros (T val) { return val == 0 ? 8*sizeof(T) : __builtin_clzll(val); } #elif defined(_MSC_VER) #include template typename std::enable_if::type count_leading_zeros (T val) { unsigned long index; return _BitScanReverse(&index, val) ? static_cast(8*sizeof(T)-1-index) : 8*sizeof(T); } #else // fallback implementation if no built-in clz function is available template typename std::enable_if::type count_leading_zeros (T val) { uint32_t val32 = val; static const uint8_t clz_table[16] = {4, 3, 2, 2, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, 0}; int n=0; if ((val32 & 0xFFFF0000) == 0) {n = 16; val32 <<= 16;} if ((val32 & 0xFF000000) == 0) {n += 8; val32 <<= 8;} if ((val32 & 0xF0000000) == 0) {n += 4; val32 <<= 4;} return n + clz_table[val32 >> (32-4)] - (32-8*sizeof(T)); } #endif /** Returns floor(log2(n)) where n is a positive integer. * If n < 1, it returns -1. */ template int ilog2 (T n) { return n > 0 ? 8*sizeof(T)-1-count_leading_zeros(n) : -1; } template struct set_const_of { template struct by { using type = typename std::conditional< std::is_const::value, typename std::add_const::type, typename std::remove_const::type >::type; }; }; class Date { public: Date (int year, int month, int day) : _year(year), _month(month-1), _day(day-1) {} bool operator < (const Date &date) const; size_t operator - (Date date2) const; private: int _year, _month, _day; // _month and _day are 0-based }; } // namespace util #endif