00001 /* /////////////////////////////////////////////////////////////////////////
00002  * File:        fastformat/sinks/ACE_CString.hpp
00003  *
00004  * Purpose:     A FastFormat sink adaptor for ACE's ACE_CString.
00005  *
00006  * Created:     2nd January 2009
00007  * Updated:     18th January 2009
00008  *
00009  * Home:        http://www.fastformat.org/
00010  *
00011  * Copyright (c) 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_ACE_CSTRING
00048 #define FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_ACE_CSTRING
00049 
00050 /* /////////////////////////////////////////////////////////////////////////
00051  * Version information
00052  */
00053 
00054 #ifndef FASTFORMAT_DOCUMENTATION_SKIP_SECTION
00055 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_ACE_CSTRING_MAJOR       1
00056 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_ACE_CSTRING_MINOR       1
00057 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_ACE_CSTRING_REVISION    1
00058 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_ACE_CSTRING_EDIT        3
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/quality/contract.h>
00075 #include <fastformat/format/standard_flags.hpp>
00076 #include <fastformat/util/sinks/helpers.hpp>
00077 
00078 #include <atlbase.h>
00079 
00080 /* /////////////////////////////////////////////////////////////////////////
00081  * Namespace
00082  */
00083 
00084 #if !defined(FASTFORMAT_NO_NAMESPACE)
00085 namespace fastformat
00086 {
00087 namespace sinks
00088 {
00089 #endif /* !FASTFORMAT_NO_NAMESPACE */
00090 
00091 /* /////////////////////////////////////////////////////////////////////////
00092  * Action Shims
00093  */
00094 
00098 inline ACE_CString& fmt_slices(ACE_CString& sink, int flags, size_t cchTotal, size_t numResults, ff_string_slice_t const* results)
00099 {
00100 #if !defined(FASTFORMAT_NO_NAMESPACE)
00101     using ::fastformat::util::concat_slices;
00102 #endif /* !FASTFORMAT_NO_NAMESPACE */
00103 
00104     if( 0 != cchTotal ||
00105         0 != flags)
00106     {
00107         const ff_string_slice_t crlf = fastformat_getNewlineForPlatform();
00108 
00109         if(flags::ff_newLine & flags)
00110         {
00111             cchTotal += crlf.len;
00112         }
00113 
00114 #if ACE_MAJOR_VERSION < 5 || \
00115     (   ACE_MAJOR_VERSION == 5 && \
00116         ACE_MINOR_VERSION < 6)
00117 
00118 #else /* ? ACE <5.6 */
00119 
00120         // TODO: Optimise later, by doing a reserve() like operation, and
00121         // then writing directly into string
00122 
00123         const size_t    initialSize     =   sink.length();
00124         const size_t    requiredSize    =   initialSize + cchTotal;
00125 
00126 #endif /* ACE <5.6 */
00127 
00128         stlsoft::auto_buffer<ff_char_t> buff(1 + cchTotal);
00129 
00130         concat_slices(buff, numResults, results);
00131         if(flags::ff_newLine & flags)
00132         {
00133             ::memcpy(&buff[0] + (cchTotal - crlf.len), crlf.ptr, crlf.len * sizeof(ff_char_t));
00134         }
00135         buff[cchTotal] = '\0';
00136 
00137         sink += ACE_CString(buff.data(), cchTotal);
00138     }
00139 
00140     return sink;
00141 }
00142 
00143 /* /////////////////////////////////////////////////////////////////////////
00144  * Namespace
00145  */
00146 
00147 #if !defined(FASTFORMAT_NO_NAMESPACE)
00148 } /* namespace sinks */
00149 } /* namespace fastformat */
00150 #endif /* !FASTFORMAT_NO_NAMESPACE */
00151 
00152 /* ////////////////////////////////////////////////////////////////////// */
00153 
00154 #endif /* FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_ACE_CSTRING */
00155 
00156 /* ////////////////////////////////////////////////////////////////////// */

FastFormat Library documentation � Matthew Wilson, 2006-2009