00001 /* /////////////////////////////////////////////////////////////////////////
00002  * File:        fastformat/sinks/CString.hpp
00003  *
00004  * Purpose:     A FastFormat sink adaptor for MFC's CString.
00005  *
00006  * Created:     2nd June 2008
00007  * Updated:     10th June 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_CSTRING
00048 #define FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_CSTRING
00049 
00050 /* /////////////////////////////////////////////////////////////////////////
00051  * Version information
00052  */
00053 
00054 #ifndef FASTFORMAT_DOCUMENTATION_SKIP_SECTION
00055 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_CSTRING_MAJOR      1
00056 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_CSTRING_MINOR      2
00057 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_CSTRING_REVISION   4
00058 # define FASTFORMAT_VER_FASTFORMAT_SINK_HPP_CSTRING_EDIT       11
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 <afx.h> // MFC requires that it is the first includer of Windows.h
00074 
00075 #include <fastformat/fastformat.h>
00076 #include <fastformat/quality/contract.h>
00077 #include <fastformat/format/standard_flags.hpp>
00078 #include <fastformat/util/sinks/helpers.hpp>
00079 
00080 #include <mfcstl/string/grab_cstring_buffer.hpp>
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 CString& fmt_slices(CString& sink, int flags, size_t cchTotal, size_t numResults, ff_string_slice_t const* results)
00101 {
00102     try
00103     {
00104 #if !defined(FASTFORMAT_NO_NAMESPACE)
00105         using ::fastformat::util::concat_slices;
00106 #endif /* !FASTFORMAT_NO_NAMESPACE */
00107 
00108         const ff_string_slice_t crlf = fastformat_getNewlineForPlatform();
00109 
00110         if(flags::ff_newLine & flags)
00111         {
00112             cchTotal += crlf.len;
00113         }
00114 
00115         mfcstl::grab_cstring_buffer buff(sink, static_cast<int>(cchTotal) + sink.GetLength());
00116         ff_char_t*                  base    =   buff;
00117         size_t                      n       =   concat_slices(cchTotal, base + buff.original_length(), numResults, results);
00118 
00119         n += buff.original_length();
00120 
00121         if(flags::ff_newLine & flags)
00122         {
00123             ::memcpy(base + n, crlf.ptr, crlf.len * sizeof(ff_char_t));
00124             n += crlf.len;
00125         }
00126         base[n] = '\0';
00127     }
00128     catch(CMemoryException* px)
00129     {
00130         px->Delete();
00131 
00132         throw std::bad_alloc();
00133     }
00134 
00135     return sink;
00136 }
00137 
00138 /* /////////////////////////////////////////////////////////////////////////
00139  * Namespace
00140  */
00141 
00142 #if !defined(FASTFORMAT_NO_NAMESPACE)
00143 } /* namespace sinks */
00144 } /* namespace fastformat */
00145 #endif /* !FASTFORMAT_NO_NAMESPACE */
00146 
00147 /* ////////////////////////////////////////////////////////////////////// */
00148 
00149 #endif /* FASTFORMAT_INCL_FASTFORMAT_SINK_HPP_CSTRING */
00150 
00151 /* ////////////////////////////////////////////////////////////////////// */

FastFormat Library documentation � Matthew Wilson, 2006-2009