Coin: SbPimplPtr.h Source File

| Coin3D is Free Software, published under the BSD 3-clause license. | https://coin3d.github.io https://www.kongsberg.com/en/kogt/

SbPimplPtr.h
1#ifndef COIN_SBPIMPLPTR_H
2#define COIN_SBPIMPLPTR_H
3
4/**************************************************************************\
5 * Copyright (c) Kongsberg Oil & Gas Technologies AS
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
10 * met:
11 *
12 * Redistributions of source code must retain the above copyright notice,
13 * this list of conditions and the following disclaimer.
14 *
15 * Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * Neither the name of the copyright holder nor the names of its
20 * contributors may be used to endorse or promote products derived from
21 * this software without specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
26 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
27 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
28 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
29 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
30 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
31 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
32 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34\**************************************************************************/
35
36// The SbPimplPtr<> class is loosely based on the boost::pimpl_ptr<>-
37// proposal of 2005 by Asger Mangaard.
38//
39// It is reimplemented here as separate classes, not with policy-based
40// templates, because we still try to support compilers that don't support
41// template templates (e.g. Visual C++ 6).
42//
43// See also SbLazyPimplPtr<>, our implementation of the lazy-creation policy.
44
45#include <Inventor/SbBasic.h>
46
47/* ********************************************************************** */
48
49#if defined(_MSC_VER) && (_MSC_VER < 1400) /* MSVC <8 */
50#pragma warning(push)
51#pragma warning(disable:4251) // for DLL-interface warning
52#endif /* MSVC <8 */
53
54template <typename T>
55 class COIN_DLL_API SbPimplPtr {
56public:
57 SbPimplPtr(void);
58 SbPimplPtr(T * initial);
59 SbPimplPtr(const SbPimplPtr<T> & copy);
60 ~SbPimplPtr(void);
61
62 void set(T * value);
63 T & get(void) const;
64
65 SbPimplPtr<T> & operator = (const SbPimplPtr<T> & copy);
66
67 SbBool operator == (const SbPimplPtr<T> & rhs) const;
68 SbBool operator != (const SbPimplPtr<T> & rhs) const;
69
70 const T * operator -> (void) const;
71 T * operator -> (void);
72
73protected:
74 T * getNew(void) const;
75
76protected:
77 T * ptr;
78
79}; // SbPimplPtr
80
81#ifdef COIN_INTERNAL
82// the implementation is in the .hpp class
83#include <Inventor/tools/SbPimplPtr.hpp>
84#endif // COIN_INTERNAL
85
86#if defined(_MSC_VER) && (_MSC_VER < 1400) /* MSVC <8 */
87#pragma warning(pop)
88#endif /* MSVC <8 */
89
90/* ********************************************************************** */
91
92#endif // !COIN_SBPIMPLPTR_H