📄 method_properties.hpp
字号:
/* /////////////////////////////////////////////////////////////////////////
* File: stlsoft/properties/method_properties.hpp (originally stlsoft_method_properties.h)
*
* Purpose: Method-based properties.
*
* Created: 6th October 2003
* Updated: 10th June 2006
*
* Home: http://stlsoft.org/
*
* Copyright (c) 2003-2006, Matthew Wilson and Synesis Software
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* - Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
* - Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
* - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of
* any contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
* ////////////////////////////////////////////////////////////////////// */
/** \file stlsoft/properties/method_properties.hpp
*
* \brief [C++ only] Definition of the method property implementation
* class templates:
* stlsoft::method_property_get,
* stlsoft::method_property_set,
* stlsoft::method_property_getset,
* stlsoft::method_property_get_external,
* stlsoft::method_property_set_external,
* stlsoft::method_property_getset_external,
* stlsoft::static_method_property_get,
* stlsoft::static_method_property_set
* stlsoft::static_method_property_getset,
* stlsoft::static_method_property_get_external,
* stlsoft::static_method_property_set_external
* and
* stlsoft::static_method_property_getset_external.
* (\ref group__library__properties "Properties" Library.)
*/
#ifndef STLSOFT_INCL_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES
#define STLSOFT_INCL_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
# define STLSOFT_VER_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES_MAJOR 4
# define STLSOFT_VER_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES_MINOR 0
# define STLSOFT_VER_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES_REVISION 1
# define STLSOFT_VER_STLSOFT_PROPERTIES_HPP_METHOD_PROPERTIES_EDIT 46
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* /////////////////////////////////////////////////////////////////////////
* Compatibility
*/
/*
[Incompatibilies-start]
STLSOFT_COMPILER_IS_GCC: __GNUC__ == 3 && defined(__APPLE__)
STLSOFT_COMPILER_IS_WATCOM:
[Incompatibilies-end]
*/
/* /////////////////////////////////////////////////////////////////////////
* Includes
*/
#ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT
# include <stlsoft/stlsoft.h>
#endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */
/* /////////////////////////////////////////////////////////////////////////
* Compatibility
*/
/* Don't want all the nasty crud for handling backwards compilers included in
* the documentation
*/
#if defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
# define STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#endif /* STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* Certain compilers are too hopeless to help in any conceivable way. */
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
/* Compatible */
#elif ( defined(STLSOFT_COMPILER_IS_MSVC) && \
_MSC_VER < 1200)
# error Compiler is not compatible with method properties
#endif /* compiler */
/* /////////////////////////////////////////////////////////////////////////
* Namespace
*/
#ifndef _STLSOFT_NO_NAMESPACE
namespace stlsoft
{
#endif /* _STLSOFT_NO_NAMESPACE */
/* /////////////////////////////////////////////////////////////////////////
* Macros
*/
#define STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
\
P##_prop_offset_##C
/** \def STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET
*
* \ingroup group__library__properties
*
* \param C The containing class type
* \param P The property name
*/
#define STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
static ptrdiff_t STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P)() \
{ \
return STLSOFT_RAW_OFFSETOF(C, P); \
}
/** \def STLSOFT_METHOD_PROPERTY_GET
*
* \ingroup group__library__properties
*
* \param V The value type
* \param R The value reference type
* \param C The containing class type
* \param GM The property get accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#define STLSOFT_METHOD_PROPERTY_GET(V, R, C, GM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_get)< V \
, R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::GM \
> P
#else /* ? STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
#define STLSOFT_METHOD_PROPERTY_GET(V, R, C, GM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_get)< V \
, R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
> P
#endif /* STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
/** \def STLSOFT_METHOD_PROPERTY_SET
*
* \ingroup group__library__properties
*
* \param V The value type
* \param R The value reference type
* \param C The containing class type
* \param SM The property set accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#define STLSOFT_METHOD_PROPERTY_SET(V, R, C, SM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_set)< V \
, R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::SM \
> P
#else /* ? STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
#endif /* STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
/** \def STLSOFT_METHOD_PROPERTY_GETSET
*
* \ingroup group__library__properties
*
* \param V The value type
* \param RG The get reference type
* \param RS The set reference type
* \param C The containing class type
* \param GM The property get accessor method
* \param SM The property set accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
# define STLSOFT_METHOD_PROPERTY_GETSET(V, RG, RS, C, GM, SM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_getset)< V \
, RG \
, RS \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::GM \
, &C::SM \
> P
#else /* ? STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
# define STLSOFT_METHOD_PROPERTY_GETSET(V, RG, RS, C, GM, SM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_getset)< V \
, RG \
, RS \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
> P
#endif /* STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
/** \def STLSOFT_METHOD_PROPERTY_GET_EXTERNAL
*
* \ingroup group__library__properties
*
* \param R The value reference type
* \param C The containing class type
* \param GM The property get accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#define STLSOFT_METHOD_PROPERTY_GET_EXTERNAL_PROP(R, C, GM, P) \
\
stlsoft_ns_qual(method_property_get_external)< R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::GM \
> P
#define STLSOFT_METHOD_PROPERTY_GET_EXTERNAL(R, C, GM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
STLSOFT_METHOD_PROPERTY_GET_EXTERNAL_PROP(R, C, GM, P)
#else /* ? STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
#define STLSOFT_METHOD_PROPERTY_GET_EXTERNAL(R, C, GM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
\
stlsoft_ns_qual(method_property_get_external)< R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
> P
#endif /* STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
/** \def STLSOFT_METHOD_PROPERTY_SET_EXTERNAL
*
* \ingroup group__library__properties
*
* \param R The value reference type
* \param C The containing class type
* \param SM The property set accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#define STLSOFT_METHOD_PROPERTY_SET_EXTERNAL_PROP(R, C, SM, P) \
\
stlsoft_ns_qual(method_property_set_external)< R \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::SM \
> P
#define STLSOFT_METHOD_PROPERTY_SET_EXTERNAL(R, C, SM, P) \
\
STLSOFT_METHOD_PROPERTY_DEFINE_OFFSET(C, P) \
STLSOFT_METHOD_PROPERTY_SET_EXTERNAL_PROP(R, C, SM, P)
#else /* ? STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
#endif /* STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT */
/** \def STLSOFT_METHOD_PROPERTY_GETSET_EXTERNAL
*
* \ingroup group__library__properties
*
* \param RG The get reference type
* \param RS The set reference type
* \param C The containing class type
* \param GM The property get accessor method
* \param SM The property set accessor method
* \param P The property name
*
* TODO: EXAMPLE HERE
*/
#ifdef STLSOFT_CF_MEM_FUNC_AS_TEMPLATE_PARAM_SUPPORT
#define STLSOFT_METHOD_PROPERTY_GETSET_EXTERNAL_PROP(RG, RS, C, GM, SM, P) \
\
stlsoft_ns_qual(method_property_getset_external)< RG \
, RS \
, C \
, &C::STLSOFT_METHOD_PROPERTY_OFFSET_NAME(C, P) \
, &C::GM \
, &C::SM \
> P
#define STLSOFT_METHOD_PROPERTY_GETSET_EXTERNAL(RG, RS, C, GM, SM, P) \
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -