This file is indexed.

/usr/include/InsightToolkit/Numerics/FEM/itkFEMP.h is in libinsighttoolkit3-dev 3.20.1-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
/*=========================================================================

  Program:   Insight Segmentation & Registration Toolkit
  Module:    itkFEMP.h
  Language:  C++
  Date:      $Date$
  Version:   $Revision$

  Copyright (c) Insight Software Consortium. All rights reserved.
  See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm for details.

     This software is distributed WITHOUT ANY WARRANTY; without even 
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
     PURPOSE.  See the above copyright notices for more information.

=========================================================================*/
#ifndef __itkFEMP_h
#define __itkFEMP_h

namespace itk {
namespace fem {

/**
 * \class FEMP
 * \brief Pointer used to store polymorphic elements in STL arrays.
 *
 * FEMP holds a pointer to objects of class T and its derived classes. it
 * behaves like a special kind of pointer. Special pointers to object can
 * be used to store polymorphic arrays in STL. The basic idea of the special
 * pointer is: whatever you do to the pointer (object of class FEMP), is
 * also reflected on the object within (pointed to by m_Data member). For
 * example: if you copy the special pointer, an object within is also copied.
 *
 * Class T should have a member Clone() which produces a copy of an object.
 * This is important in polymorphic classes, where object of the derived
 * class should be created when copying an existing object.
 *
 * Class T should also include typedefs T::Pointer and T::ConstPointer that
 * define standard pointers to the class. Note that these could be
 * SmartPointer classes.
 */
template<class T>
class FEMP
{
public:

  /**
   * Default constructor makes sure that m_Data is 0,
   * to prevent problems when deleting m_Data object
   * on destruction.
   */
  FEMP() : m_Data(0)
    {
    }
  
  /**
   * Copy constructor. Clone() method is called
   * to duplicate the existing object.
   */
  FEMP(const FEMP& x)
    {
    if (x.m_Data)
      {
      m_Data=static_cast<T*>(&*x.m_Data->Clone());
      }
    else
      {
      m_Data=0;
      }
    }

  /**
   * Conversion constructor from T::Pointer to FEMP<T>.
   * The object T* must exist and we take ownership of object T*.
   * If you want to create a copy of object and take ownership of that,
   * use: FEMP(x->Clone()) instead of FEMP(x).
   */
  explicit FEMP(typename T::Pointer x) : m_Data(x)
    {}
  
  /**
   * Destructor of a special pointer class also destroys the actual object.
   */
  ~FEMP()
    {
    #ifndef FEM_USE_SMART_POINTERS
    delete m_Data;
    #endif
    }

  /**
   * Asignment operator
   */  
  const FEMP& operator= (const FEMP &rhs);

  /**
   * Easy access to members of stored object
   */
  typename T::Pointer operator-> () const { return m_Data; }
  
  /**
   * Dereferencing operator provides automatic conversion from 
   * special to standard pointer to object
   */  
  operator T * () const
    {
    return m_Data;
    }
  
  /**
   * Return true if special pointer actually points
   * to a valid object and false otherwise.
   */
  bool IsNULL() const
    {
    return (m_Data==0);
    }

private:

  /**
   * Pointer to actual object. Note that this could be a SmartPointer.
   */
  typename T::Pointer m_Data;

};

template<class T>
const FEMP<T>& FEMP<T>::operator= (const FEMP &rhs)
{

  /** Self assignments don't make sense. */
  if (&rhs!=this) 
    {
    /**
     * First destroy the existing object on the left hand side
     */
    #ifndef FEM_USE_SMART_POINTERS
    delete m_Data;
    #else
    m_Data=0;
    #endif

    /**
     * Then clone the one on the right hand side
     * of the expression (if not NULL).
     */
    if (rhs.m_Data)
      {
      m_Data=static_cast<T*>(&*rhs.m_Data->Clone());
      }
    else
      {
      m_Data=0;
      }

    }
  return *this;
}

}} // end namespace itk::fem

#endif // #ifndef __itkFEMP_h