miniassimp

annotate include/miniassimp/TinyFormatter.h @ 0:879c81d94345

find changesets by author, revision, files, or words in the commit message
initial commit
author John Tsiombikas <nuclear@member.fsf.org>
date Mon, 28 Jan 2019 18:19:26 +0200
parents
children
rev   line source
nuclear@0 1 /*
nuclear@0 2 Open Asset Import Library (assimp)
nuclear@0 3 ----------------------------------------------------------------------
nuclear@0 4
nuclear@0 5 Copyright (c) 2006-2018, assimp team
nuclear@0 6
nuclear@0 7
nuclear@0 8 All rights reserved.
nuclear@0 9
nuclear@0 10 Redistribution and use of this software in source and binary forms,
nuclear@0 11 with or without modification, are permitted provided that the
nuclear@0 12 following conditions are met:
nuclear@0 13
nuclear@0 14 * Redistributions of source code must retain the above
nuclear@0 15 copyright notice, this list of conditions and the
nuclear@0 16 following disclaimer.
nuclear@0 17
nuclear@0 18 * Redistributions in binary form must reproduce the above
nuclear@0 19 copyright notice, this list of conditions and the
nuclear@0 20 following disclaimer in the documentation and/or other
nuclear@0 21 materials provided with the distribution.
nuclear@0 22
nuclear@0 23 * Neither the name of the assimp team, nor the names of its
nuclear@0 24 contributors may be used to endorse or promote products
nuclear@0 25 derived from this software without specific prior
nuclear@0 26 written permission of the assimp team.
nuclear@0 27
nuclear@0 28 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
nuclear@0 29 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
nuclear@0 30 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
nuclear@0 31 A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
nuclear@0 32 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
nuclear@0 33 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
nuclear@0 34 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
nuclear@0 35 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
nuclear@0 36 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
nuclear@0 37 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
nuclear@0 38 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
nuclear@0 39
nuclear@0 40 ----------------------------------------------------------------------
nuclear@0 41 */
nuclear@0 42
nuclear@0 43 /** @file TinyFormatter.h
nuclear@0 44 * @brief Utility to format log messages more easily. Introduced
nuclear@0 45 * to get rid of the boost::format dependency. Much slinker,
nuclear@0 46 * basically just extends stringstream.
nuclear@0 47 */
nuclear@0 48 #ifndef INCLUDED_TINY_FORMATTER_H
nuclear@0 49 #define INCLUDED_TINY_FORMATTER_H
nuclear@0 50
nuclear@0 51 #include <sstream>
nuclear@0 52
nuclear@0 53 namespace Assimp {
nuclear@0 54 namespace Formatter {
nuclear@0 55
nuclear@0 56 // ------------------------------------------------------------------------------------------------
nuclear@0 57 /** stringstream utility. Usage:
nuclear@0 58 * @code
nuclear@0 59 * void writelog(const std::string&s);
nuclear@0 60 * void writelog(const std::wstring&s);
nuclear@0 61 * ...
nuclear@0 62 * writelog(format()<< "hi! this is a number: " << 4);
nuclear@0 63 * writelog(wformat()<< L"hi! this is a number: " << 4);
nuclear@0 64 *
nuclear@0 65 * @endcode */
nuclear@0 66 template < typename T,
nuclear@0 67 typename CharTraits = std::char_traits<T>,
nuclear@0 68 typename Allocator = std::allocator<T>
nuclear@0 69 >
nuclear@0 70 class basic_formatter
nuclear@0 71 {
nuclear@0 72
nuclear@0 73 public:
nuclear@0 74
nuclear@0 75 typedef class std::basic_string<
nuclear@0 76 T,CharTraits,Allocator
nuclear@0 77 > string;
nuclear@0 78
nuclear@0 79 typedef class std::basic_ostringstream<
nuclear@0 80 T,CharTraits,Allocator
nuclear@0 81 > stringstream;
nuclear@0 82
nuclear@0 83 public:
nuclear@0 84
nuclear@0 85 basic_formatter() {}
nuclear@0 86
nuclear@0 87 /* Allow basic_formatter<T>'s to be used almost interchangeably
nuclear@0 88 * with std::(w)string or const (w)char* arguments because the
nuclear@0 89 * conversion c'tor is called implicitly. */
nuclear@0 90 template <typename TT>
nuclear@0 91 basic_formatter(const TT& sin) {
nuclear@0 92 underlying << sin;
nuclear@0 93 }
nuclear@0 94
nuclear@0 95
nuclear@0 96 // The problem described here:
nuclear@0 97 // https://sourceforge.net/tracker/?func=detail&atid=1067632&aid=3358562&group_id=226462
nuclear@0 98 // can also cause trouble here. Apparently, older gcc versions sometimes copy temporaries
nuclear@0 99 // being bound to const ref& function parameters. Copying streams is not permitted, though.
nuclear@0 100 // This workaround avoids this by manually specifying a copy ctor.
nuclear@0 101 #if !defined(__GNUC__) || !defined(__APPLE__) || __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)
nuclear@0 102 explicit basic_formatter(const basic_formatter& other) {
nuclear@0 103 underlying << (string)other;
nuclear@0 104 }
nuclear@0 105 #endif
nuclear@0 106
nuclear@0 107
nuclear@0 108 public:
nuclear@0 109
nuclear@0 110 operator string () const {
nuclear@0 111 return underlying.str();
nuclear@0 112 }
nuclear@0 113
nuclear@0 114
nuclear@0 115 /* note - this is declared const because binding temporaries does only
nuclear@0 116 * work for const references, so many function prototypes will
nuclear@0 117 * include const basic_formatter<T>& s but might still want to
nuclear@0 118 * modify the formatted string without the need for a full copy.*/
nuclear@0 119 template <typename TToken>
nuclear@0 120 const basic_formatter& operator << (const TToken& s) const {
nuclear@0 121 underlying << s;
nuclear@0 122 return *this;
nuclear@0 123 }
nuclear@0 124
nuclear@0 125 template <typename TToken>
nuclear@0 126 basic_formatter& operator << (const TToken& s) {
nuclear@0 127 underlying << s;
nuclear@0 128 return *this;
nuclear@0 129 }
nuclear@0 130
nuclear@0 131
nuclear@0 132 // comma operator overloaded as well, choose your preferred way.
nuclear@0 133 template <typename TToken>
nuclear@0 134 const basic_formatter& operator, (const TToken& s) const {
nuclear@0 135 underlying << s;
nuclear@0 136 return *this;
nuclear@0 137 }
nuclear@0 138
nuclear@0 139 template <typename TToken>
nuclear@0 140 basic_formatter& operator, (const TToken& s) {
nuclear@0 141 underlying << s;
nuclear@0 142 return *this;
nuclear@0 143 }
nuclear@0 144
nuclear@0 145 // Fix for MSVC8
nuclear@0 146 // See https://sourceforge.net/projects/assimp/forums/forum/817654/topic/4372824
nuclear@0 147 template <typename TToken>
nuclear@0 148 basic_formatter& operator, (TToken& s) {
nuclear@0 149 underlying << s;
nuclear@0 150 return *this;
nuclear@0 151 }
nuclear@0 152
nuclear@0 153
nuclear@0 154 private:
nuclear@0 155 mutable stringstream underlying;
nuclear@0 156 };
nuclear@0 157
nuclear@0 158
nuclear@0 159 typedef basic_formatter< char > format;
nuclear@0 160 typedef basic_formatter< wchar_t > wformat;
nuclear@0 161
nuclear@0 162 } // ! namespace Formatter
nuclear@0 163
nuclear@0 164 } // ! namespace Assimp
nuclear@0 165
nuclear@0 166 #endif