00001 /* /////////////////////////////////////////////////////////////////////////
00002  * File:        fastformat/sinks/FILE.hpp
00003  *
00004  * Purpose:     A FastFormat sink for FILE*.
00005  *
00006  * Created:     3rd January 2008
00007  * Updated:     29th April 2009
00008  *
00009  * Home:        http://www.fastformat.org/
00010  *
00011  * Copyright (c) 2008-2009, 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_FILE
00048 #define FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_FILE
00049 
00050 /* /////////////////////////////////////////////////////////////////////////
00051  * Version information
00052  */
00053 
00054 #ifndef FASTFORMAT_DOCUMENTATION_SKIP_SECTION
00055 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_FILE_MAJOR      1
00056 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_FILE_MINOR      1
00057 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_FILE_REVISION   4
00058 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_FILE_EDIT       17
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 <platformstl/error/exceptions.hpp>
00078 #include <stlsoft/memory/auto_buffer.hpp>
00079 
00080 #include <stdio.h>
00081 
00082 /* /////////////////////////////////////////////////////////////////////////
00083  * Namespace
00084  */
00085 
00086 #if !defined(FASTFORMAT_NO_NAMESPACE)
00087 namespace fastformat
00088 {
00089 namespace sinks
00090 {
00091 #endif /* !FASTFORMAT_NO_NAMESPACE */
00092 
00093 /* /////////////////////////////////////////////////////////////////////////
00094  * Action Shims
00095  */
00096 
00100 inline FILE*& fmt_slices(FILE*& sink, int flags, size_t cchTotal, size_t numResults, ff_string_slice_t const* results)
00101 {
00102 #ifndef FASTFORMAT_FILE_SINK_OLD_IMPLEMENTATION
00103 
00104     stlsoft::auto_buffer<ff_char_t> buff(cchTotal + 1 + 1); // 1 for \0, 1 for newline (if needed)
00105     int                             n = 0;
00106 
00107 # ifndef STLSOFT_CF_THROW_BAD_ALLOC
00108     if(!buff.empty())
00109 # endif /* !STLSOFT_CF_THROW_BAD_ALLOC */
00110     {
00111 # if !defined(FASTFORMAT_NO_NAMESPACE)
00112         using ::fastformat::util::concat_slices;
00113 # endif /* !FASTFORMAT_NO_NAMESPACE */
00114 
00115         size_t n2 = concat_slices(buff, numResults, results);
00116         if(flags::ff_newLine & flags)
00117         {
00118             buff[n2++] = '\n';
00119         }
00120         buff[n2++] = '\0';
00121 
00122 # ifdef FASTFORMAT_USE_WIDE_STRINGS
00123         n = ::fputws(
00124 # else /* ? FASTFORMAT_USE_WIDE_STRINGS */
00125         n = ::fputs(
00126 # endif /* FASTFORMAT_USE_WIDE_STRINGS */
00127             buff.data()
00128         ,   sink
00129         );
00130     }
00131 
00132     if( n >= 0 &&
00133         0 != (flags::ff_flush & flags))
00134     {
00135         ::fflush(sink);
00136     }
00137 
00138 #else /* ? !FASTFORMAT_FILE_SINK_OLD_IMPLEMENTATION */
00139 
00140     stlsoft::auto_buffer<ff_char_t> buff(cchTotal);
00141     int                             n = 0;
00142 
00143 # ifndef STLSOFT_CF_THROW_BAD_ALLOC
00144     if(!buff.empty())
00145 # endif /* !STLSOFT_CF_THROW_BAD_ALLOC */
00146     {
00147 # if !defined(FASTFORMAT_NO_NAMESPACE)
00148         using ::fastformat::util::concat_slices;
00149 # endif /* !FASTFORMAT_NO_NAMESPACE */
00150 
00151         concat_slices(buff, numResults, results);
00152 
00153 # ifdef FASTFORMAT_USE_WIDE_STRINGS
00154         n = ::fwprintf(
00155 # else /* ? FASTFORMAT_USE_WIDE_STRINGS */
00156         n = ::fprintf(
00157 # endif /* FASTFORMAT_USE_WIDE_STRINGS */
00158             sink
00159         ,   (flags::ff_newLine & flags) ? FASTFORMAT_LITERAL_STRING("%.*s\n") : FASTFORMAT_LITERAL_STRING("%.*s")
00160         ,   static_cast<int>(cchTotal), buff.data()
00161         );
00162     }
00163 
00164     if( n >= 0 &&
00165         0 != (flags::ff_flush & flags))
00166     {
00167         ::fflush(sink);
00168     }
00169 
00170 #endif /* !FASTFORMAT_FILE_SINK_OLD_IMPLEMENTATION */
00171 
00172     return sink;
00173 }
00174 
00175 /* /////////////////////////////////////////////////////////////////////////
00176  * Namespace
00177  */
00178 
00179 #if !defined(FASTFORMAT_NO_NAMESPACE)
00180 } /* namespace sinks */
00181 } /* namespace fastformat */
00182 #endif /* !FASTFORMAT_NO_NAMESPACE */
00183 
00184 /* /////////////////////////////////////////////////////////////////////////
00185  * Inclusion
00186  */
00187 
00188 #ifdef STLSOFT_CF_PRAGMA_ONCE_SUPPORT
00189 # pragma once
00190 #endif /* STLSOFT_CF_PRAGMA_ONCE_SUPPORT */
00191 
00192 /* ////////////////////////////////////////////////////////////////////// */
00193 
00194 #endif /* FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_FILE */
00195 
00196 /* ////////////////////////////////////////////////////////////////////// */

FastFormat Library documentation � Matthew Wilson, 2006-2009