File: Reflection

package info (click to toggle)
openscenegraph 2.8.3-5
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 33,968 kB
  • ctags: 30,935
  • sloc: cpp: 287,169; ansic: 9,050; sh: 654; yacc: 548; objc: 374; makefile: 264; lex: 151; perl: 119
file content (116 lines) | stat: -rw-r--r-- 4,612 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield 
 *
 * This library is open source and may be redistributed and/or modified under  
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or 
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
 * OpenSceneGraph Public License for more details.
*/
//osgIntrospection - Copyright (C) 2005 Marco Jez

#ifndef OSGINTROSPECTION_REFLECTION_
#define OSGINTROSPECTION_REFLECTION_

#include <osgIntrospection/Export>
#include <osgIntrospection/ExtendedTypeInfo>

#include <typeinfo>
#include <map>
#include <vector>
#include <list>

/// This macro emulates the behavior of the standard typeid operator,
/// returning the Type object associated to the type of the given
/// expression.
#define typeof(type)  osgIntrospection::Reflection::getType(extended_typeid< type >())
#define typeofvalue(val)  osgIntrospection::Reflection::getType(osgIntrospection::ExtendedTypeInfo(typeid(val), false, false))

namespace osgIntrospection
{

    class Type;
    struct Converter;
    
    typedef std::list<const Converter* > ConverterList;

    /// A map of types, indexed by their associated ExtendedTypeInfo
    /// structure.
    typedef std::map<ExtendedTypeInfo, Type*> TypeMap;

    enum CastType
    {
        STATIC_CAST,
        DYNAMIC_CAST,
        REINTERPRET_CAST,
        COMPOSITE_CAST
    };

    /// This class provides basic reflection services such as registration
    /// of new types and queries on the global type map.
    class OSGINTROSPECTION_EXPORT Reflection
    {
    public:
        /// Returns the Type object associated to the given
        /// ExtendedTypeInfo structure. If the type hasn't been created
        /// yet it is automatically created and added to the global type
        /// map.  Please note that such type will have the status of
        /// "declared", you still need to give details about it through
        /// a Reflector class before you can query it.
        static const Type& getType(const ExtendedTypeInfo &ti);

        /// Finds a Type object given its qualified name, which must
        /// be identical to the qualified name returned by that Type's
        /// getQualifiedName() method. If the type hasn't been created
        /// yet, an exception is thrown.
        static const Type& getType(const std::string& qname);

        /// Returns the global map of types.
        static const TypeMap& getTypes();

        /// Return the Type object associated to the C++ type 'void'.
        /// This is a shortcut for typeof(void), which may be slow if
        /// the type map is large.
        static const Type& type_void();

        static const Converter* getConverter(const Type& source, const Type& dest);
        static bool getConversionPath(const Type& source, const Type& dest, ConverterList& conv);
        
        // This function should be called (at least on windows platforms using Visual Studio 7.1 or 8 as compiler) to unregister 
        // all the known types before exiting your program: otherwise, you will get a lot of false positive memory leaks in debug builds.
        // It might also be used to dynamically reload the description of the known types (?)
        static void uninitialize();
        
    private:
        template<typename C> friend class Reflector;
        template<typename C> friend struct TypeNameAliasProxy;
        friend struct ConverterProxy;

        struct StaticData
        {
            TypeMap typemap;
            const Type* type_void;
            
            typedef std::map<const Type* , const Converter* > ConverterMap;
            typedef std::map<const Type* , ConverterMap> ConverterMapMap;
            ConverterMapMap convmap;
            
            ~StaticData();
        };

        static StaticData& getOrCreateStaticData();
        static Type* registerType(const ExtendedTypeInfo &ti);
        static Type* getOrRegisterType(const ExtendedTypeInfo &ti, bool replace_if_defined = false);
        static void registerConverter(const Type& source, const Type& dest, const Converter* cvt);

    private:
        static bool accum_conv_path(const Type& source, const Type& dest, ConverterList& conv, std::vector<const Type* > &chain, CastType castType);
        static StaticData* _static_data;
    };

}

#endif