00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/iterators/null_output_iterator.hpp 00003 * 00004 * Purpose: Null output iterator. 00005 * 00006 * Created: 18th February 2006 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2006-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 met: 00016 * 00017 * - Redistributions of source code must retain the above copyright notice, this 00018 * list of conditions and the following disclaimer. 00019 * - Redistributions in binary form must reproduce the above copyright notice, 00020 * this list of conditions and the following disclaimer in the documentation 00021 * and/or other materials provided with the distribution. 00022 * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of 00023 * any contributors may be used to endorse or promote products derived from 00024 * this software without specific prior written permission. 00025 * 00026 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00027 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00028 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 00029 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 00030 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 00031 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 00032 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 00033 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 00034 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 00035 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00036 * POSSIBILITY OF SUCH DAMAGE. 00037 * 00038 * ////////////////////////////////////////////////////////////////////// */ 00039 00040 00048 #ifndef STLSOFT_INCL_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR 00049 #define STLSOFT_INCL_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR 00050 00051 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00052 # define STLSOFT_VER_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR_MAJOR 1 00053 # define STLSOFT_VER_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR_MINOR 0 00054 # define STLSOFT_VER_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR_REVISION 4 00055 # define STLSOFT_VER_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR_EDIT 16 00056 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00057 00058 /* ///////////////////////////////////////////////////////////////////////// 00059 * Compatibility 00060 */ 00061 00062 /* ///////////////////////////////////////////////////////////////////////// 00063 * Includes 00064 */ 00065 00066 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00067 # include <stlsoft/stlsoft.h> 00068 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00069 #ifndef STLSOFT_INCL_STLSOFT_UTIL_STD_HPP_ITERATOR_HELPER 00070 # include <stlsoft/util/std/iterator_helper.hpp> 00071 #endif /* !STLSOFT_INCL_STLSOFT_UTIL_STD_HPP_ITERATOR_HELPER */ 00072 00073 #ifndef STLSOFT_INCL_STRING 00074 # define STLSOFT_INCL_STRING 00075 # include <string> 00076 #endif /* !STLSOFT_INCL_STRING */ 00077 00078 /* For some reason, VC++ 6.0 has an ICE if the following is not included */ 00079 #if defined(STLSOFT_COMPILER_IS_MSVC) && \ 00080 _MSC_VER == 1200 00081 # include <iterator> 00082 # include <stlsoft/string/char_traits.hpp> 00083 #endif /* compiler */ 00084 00085 #ifdef STLSOFT_UNITTEST 00086 # include <algorithm> 00087 # include <sstream> 00088 #endif /* STLSOFT_UNITTEST */ 00089 00090 /* ///////////////////////////////////////////////////////////////////////// 00091 * Namespace 00092 */ 00093 00094 #ifndef _STLSOFT_NO_NAMESPACE 00095 namespace stlsoft 00096 { 00097 #endif /* _STLSOFT_NO_NAMESPACE */ 00098 00099 /* ///////////////////////////////////////////////////////////////////////// 00100 * Classes 00101 */ 00102 00135 template< ss_typename_param_k V 00136 > 00137 // [[synesis:class:iterator: null_output_iterator<T<V>, T<C>, T<T>, T<S>>]] 00138 class null_output_iterator 00139 : public stlsoft_ns_qual(iterator_base)<stlsoft_ns_qual_std(output_iterator_tag), void, void, void, void> 00140 { 00143 public: 00145 typedef V assigned_type; 00147 typedef null_output_iterator<V> class_type; 00148 private: 00149 class deref_proxy; 00151 00154 public: 00156 00159 private: 00160 class deref_proxy 00161 { 00162 public: 00163 deref_proxy(null_output_iterator *it) 00164 : m_it(it) 00165 {} 00166 00167 public: 00168 void operator =(assigned_type const& value) 00169 { 00170 STLSOFT_SUPPRESS_UNUSED(value); 00171 } 00172 00173 private: 00174 null_output_iterator *const m_it; 00175 00176 // Not to be implemented 00177 private: 00178 void operator =(deref_proxy const&); 00179 }; 00181 00184 public: 00185 deref_proxy operator *() 00186 { 00187 return deref_proxy(this); 00188 } 00189 class_type& operator ++() 00190 { 00191 return *this; 00192 } 00193 class_type& operator ++(int) 00194 { 00195 return *this; 00196 } 00198 }; 00199 00201 // Unit-testing 00202 00203 #ifdef STLSOFT_UNITTEST 00204 //# include "./unittest/ostream_iterator_unittest_.h" 00205 #endif /* STLSOFT_UNITTEST */ 00206 00207 /* ////////////////////////////////////////////////////////////////////// */ 00208 00209 #ifndef _STLSOFT_NO_NAMESPACE 00210 } // namespace stlsoft 00211 #endif /* _STLSOFT_NO_NAMESPACE */ 00212 00213 /* ////////////////////////////////////////////////////////////////////// */ 00214 00215 #endif /* !STLSOFT_INCL_STLSOFT_ITERATORS_HPP_NULL_OUTPUT_ITERATOR */ 00216 00217 /* ///////////////////////////// end of file //////////////////////////// */