Synesis Software STLSoft - ... Robust, Lightweight, Cross-platform, Template Software ...

fastformat/sinks/OutputDebugString.hpp

00001 /* /////////////////////////////////////////////////////////////////////////
00002  * File:        fastformat/sinks/OutputDebugString.hpp
00003  *
00004  * Purpose:     A FastFormat sink for Windows' OutputDebugString().
00005  *
00006  * Created:     24th February 2009
00007  * Updated:     7th March 2010
00008  *
00009  * Home:        http://www.fastformat.org/
00010  *
00011  * Copyright (c) 2009-2010, Matthew Wilson and Synesis Software
00012  * All rights reserved.
00013  *
00014  * Redistribution and use in source and binary forms, with or without
00015  * modification, are permitted provided that the following conditions are
00016  * met:
00017  *
00018  * - Redistributions of source code must retain the above copyright notice,
00019  *   this list of conditions and the following disclaimer.
00020  * - Redistributions in binary form must reproduce the above copyright
00021  *   notice, this list of conditions and the following disclaimer in the
00022  *   documentation and/or other materials provided with the distribution.
00023  * - Neither the names of Matthew Wilson and Synesis Software nor the names
00024  *   of any contributors may be used to endorse or promote products derived
00025  *   from this software without specific prior written permission.
00026  *
00027  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
00028  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
00029  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
00030  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
00031  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
00032  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
00033  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
00034  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
00035  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
00036  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
00037  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00038  *
00039  * ////////////////////////////////////////////////////////////////////// */
00040 
00041 
00047 #ifndef FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING
00048 #define FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING
00049 
00050 /* /////////////////////////////////////////////////////////////////////////
00051  * Version information
00052  */
00053 
00054 #ifndef FASTFORMAT_DOCUMENTATION_SKIP_SECTION
00055 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING_MAJOR     1
00056 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING_MINOR     0
00057 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING_REVISION  3
00058 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING_EDIT      5
00059 #endif /* !FASTFORMAT_DOCUMENTATION_SKIP_SECTION */
00060 
00061 /* /////////////////////////////////////////////////////////////////////////
00062  * Language
00063  */
00064 
00065 #ifndef __cplusplus
00066 # error This file can only be included in C++ compilation units
00067 #endif /* !__cplusplus */
00068 
00069 /* /////////////////////////////////////////////////////////////////////////
00070  * Includes
00071  */
00072 
00073 #include <fastformat/fastformat.h>
00074 #include <fastformat/util/sinks/helpers.hpp>
00075 #include <fastformat/format/standard_flags.hpp>
00076 
00077 #include <stlsoft/memory/auto_buffer.hpp>
00078 
00079 #include <windows.h>
00080 
00081 /* /////////////////////////////////////////////////////////////////////////
00082  * Namespace
00083  */
00084 
00085 #if !defined(FASTFORMAT_NO_NAMESPACE)
00086 namespace fastformat
00087 {
00088 namespace sinks
00089 {
00090 #endif /* !FASTFORMAT_NO_NAMESPACE */
00091 
00092 #ifndef FASTFORMAT_DOCUMENTATION_SKIP_SECTION
00093 
00094 struct OutputDebugString_helper
00095 {
00096     static void fn(char const* s)
00097     {
00098         ::OutputDebugStringA(s);
00099     }
00100     static void fn(wchar_t const* s)
00101     {
00102         ::OutputDebugStringW(s);
00103     }
00104 };
00105 #endif /* !FASTFORMAT_DOCUMENTATION_SKIP_SECTION */
00106 
00107 /* /////////////////////////////////////////////////////////////////////////
00108  * Classes
00109  */
00110 
00113 class OutputDebugString_sink
00114 {
00115 public:
00117     typedef OutputDebugString_sink     class_type;
00118 
00119 public:
00121     OutputDebugString_sink()
00122     {}
00123 
00124 public:
00126     class_type& write(int flags, size_t cchTotal, size_t numResults, ff_string_slice_t const* results)
00127     {
00128         const ff_string_slice_t         newLine = fastformat_getNewlineForPlatform();
00129         stlsoft::auto_buffer<ff_char_t> buff(1 + cchTotal + ((flags::ff_newLine & flags) ? newLine.len : 0));
00130 
00131 #ifndef STLSOFT_CF_THROW_BAD_ALLOC
00132         if(!buff.empty())
00133 #endif /* !STLSOFT_CF_THROW_BAD_ALLOC */
00134         {
00135 #if !defined(FASTFORMAT_NO_NAMESPACE)
00136             using ::fastformat::util::concat_slices;
00137 #endif /* !FASTFORMAT_NO_NAMESPACE */
00138 
00139             concat_slices(buff, numResults, results);
00140 
00141             if(flags::ff_newLine & flags)
00142             {
00143                 ::memcpy(&buff[cchTotal], newLine.ptr, sizeof(ff_char_t) * newLine.len);
00144 
00145                 cchTotal += newLine.len;
00146             }
00147             buff[cchTotal] = '\0';
00148 
00149             OutputDebugString_helper::fn(buff.data());
00150         }
00151 
00152         return *this;
00153     }
00154 };
00155 
00156 /* /////////////////////////////////////////////////////////////////////////
00157  * Action Shims
00158  */
00159 
00163 inline OutputDebugString_sink& fmt_slices(OutputDebugString_sink& sink, int flags, size_t cchTotal, size_t numResults, ff_string_slice_t const* results)
00164 {
00165     return sink.write(flags, cchTotal, numResults, results);
00166 }
00167 
00168 /* /////////////////////////////////////////////////////////////////////////
00169  * Namespace
00170  */
00171 
00172 #if !defined(FASTFORMAT_NO_NAMESPACE)
00173 } /* namespace sinks */
00174 } /* namespace fastformat */
00175 #endif /* !FASTFORMAT_NO_NAMESPACE */
00176 
00177 /* /////////////////////////////////////////////////////////////////////////
00178  * Inclusion
00179  */
00180 
00181 #ifdef STLSOFT_PPF_pragma_once_SUPPORT
00182 # pragma once
00183 #endif /* STLSOFT_PPF_pragma_once_SUPPORT */
00184 
00185 /* ////////////////////////////////////////////////////////////////////// */
00186 
00187 #endif /* FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_OUTPUTDEBUGSTRING */
00188 
00189 /* ///////////////////////////// end of file //////////////////////////// */

FastFormat Library documentation © Matthew Wilson, 2006-2009 SourceForge.net Logo