00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: stlsoft/shims/access/string/std/exception.hpp 00003 * 00004 * Purpose: Contains the string access shims for std::exception. 00005 * 00006 * Created: 2nd May 2003 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2003-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_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION 00049 #define STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION 00050 00051 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00052 # define _STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION_MAJOR 2 00053 # define _STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION_MINOR 1 00054 # define _STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION_REVISION 3 00055 # define _STLSOFT_VER_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION_EDIT 35 00056 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00057 00058 /* ///////////////////////////////////////////////////////////////////////// 00059 * Includes 00060 */ 00061 00062 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT 00063 # include <stlsoft/stlsoft.h> 00064 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */ 00065 #ifndef STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_H_FWD 00066 # include <stlsoft/shims/access/string/fwd.h> 00067 #endif /* !STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_H_FWD */ 00068 #ifndef STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_H_C_STRING 00069 # include <stlsoft/shims/access/string/std/c_string.h> 00070 #endif /* !STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_H_C_STRING */ 00071 00072 #ifndef STLSOFT_INCL_EXCEPTION 00073 # define STLSOFT_INCL_EXCEPTION 00074 # include <exception> // for std::exception 00075 #endif /* !STLSOFT_INCL_EXCEPTION */ 00076 00077 /* ///////////////////////////////////////////////////////////////////////// 00078 * Namespace 00079 */ 00080 00081 #ifndef _STLSOFT_NO_NAMESPACE 00082 namespace stlsoft 00083 { 00084 #endif /* _STLSOFT_NO_NAMESPACE */ 00085 00086 /* ///////////////////////////////////////////////////////////////////////// 00087 * c_str_data 00088 * 00089 * This can be applied to an expression, and the return value is either a 00090 * pointer to the character string or to an empty string. 00091 */ 00092 00101 inline ss_char_a_t const* c_str_data_a(stlsoft_ns_qual_std(exception) const& x) 00102 { 00103 return c_str_data_a(x.what()); 00104 } 00105 00113 inline ss_char_a_t const* c_str_data(stlsoft_ns_qual_std(exception) const& x) 00114 { 00115 return c_str_data(x); 00116 } 00117 00118 /* ///////////////////////////////////////////////////////////////////////// 00119 * c_str_len 00120 * 00121 * This can be applied to an expression, and the return value is the number of 00122 * characters in the character string in the expression. 00123 */ 00124 00132 inline ss_size_t c_str_len_a(stlsoft_ns_qual_std(exception) const& x) 00133 { 00134 return c_str_len_a(x.what()); 00135 } 00136 00144 inline ss_size_t c_str_len(stlsoft_ns_qual_std(exception) const& x) 00145 { 00146 return c_str_len(x); 00147 } 00148 00149 /* ///////////////////////////////////////////////////////////////////////// 00150 * c_str_ptr 00151 * 00152 * This can be applied to an expression, and the return value is either a 00153 * pointer to the character string or to an empty string. 00154 */ 00155 00164 inline ss_char_a_t const* c_str_ptr_a(stlsoft_ns_qual_std(exception) const& x) 00165 { 00166 return c_str_ptr_a(x.what()); 00167 } 00168 00177 inline ss_char_a_t const* c_str_ptr(stlsoft_ns_qual_std(exception) const& x) 00178 { 00179 return c_str_ptr(x); 00180 } 00181 00182 /* ///////////////////////////////////////////////////////////////////////// 00183 * c_str_ptr_null 00184 * 00185 * This can be applied to an expression, and the return value is either a 00186 * pointer to the character string or NULL. 00187 */ 00188 00197 inline ss_char_a_t const* c_str_ptr_null_a(stlsoft_ns_qual_std(exception) const& x) 00198 { 00199 return c_str_ptr_null_a(x.what()); 00200 } 00201 00210 inline ss_char_a_t const* c_str_ptr_null(stlsoft_ns_qual_std(exception) const& x) 00211 { 00212 return c_str_ptr_null(x); 00213 } 00214 00215 /* ////////////////////////////////////////////////////////////////////// */ 00216 00217 #ifndef _STLSOFT_NO_NAMESPACE 00218 } // namespace stlsoft 00219 #endif /* _STLSOFT_NO_NAMESPACE */ 00220 00221 /* ////////////////////////////////////////////////////////////////////// */ 00222 00223 #endif /* !STLSOFT_INCL_STLSOFT_SHIMS_ACCESS_STRING_STD_HPP_EXCEPTION */ 00224 00225 /* ///////////////////////////// end of file //////////////////////////// */