Add Deref(T *), to ease dereferencing a pointer safely

.github/workflows/itk_dict.txt

@@ -45,6 +45,7 @@ Cz
 DDataFrameobject
 Dz
 Dasarathy
+Deref
 Dij
 Dinstein
 DownsamplerType

Modules/Core/Common/include/itkDeref.h

@@ -0,0 +1,59 @@
+/*=========================================================================
+ *
+ *  Copyright NumFOCUS
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *         https://www.apache.org/licenses/LICENSE-2.0.txt
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *=========================================================================*/
+#ifndef itkDeref_h
+#define itkDeref_h
+
+#include "itkMacro.h"
+#include <string>
+#include <typeinfo>
+
+namespace itk
+{
+
+/** \class DerefError
+ * Exception thrown when trying to dereference a null pointer.
+ * \ingroup ITKCommon
+ */
+class DerefError : public ExceptionObject
+{
+public:
+  // Inherit the constructors from its base class.
+  using ExceptionObject::ExceptionObject;
+
+  /** Runtime information support. */
+  itkTypeMacro(DerefError, ExceptionObject);
+};
+
+
+/** Dereferences the specified pointer, when the pointer is not null. Throws a `DerefError` exception when the pointer
+ * is null. Aims to avoid undefined behavior from accidentally dereferencing a null pointer.
+ */
+template <typename T>
+T &
+Deref(T * const ptr)
+{
+  if (ptr == nullptr)
+  {
+    itkSpecializedMessageExceptionMacro(
+      DerefError, "The pointer passed to `itk::Deref(T*)` is null! T's typeid name: `" << typeid(T).name() << '`');
+  }
+  return *ptr;
+}
+} // namespace itk
+
+#endif

Modules/Core/Common/test/CMakeLists.txt

@@ -1706,6 +1706,7 @@ set(ITKCommonGTests
     itkBuildInformationGTest.cxx
     itkConnectedImageNeighborhoodShapeGTest.cxx
     itkConstantBoundaryImageNeighborhoodPixelAccessPolicyGTest.cxx
+    itkDerefGTest.cxx
     itkExceptionObjectGTest.cxx
     itkFixedArrayGTest.cxx
     itkImageNeighborhoodOffsetsGTest.cxx

Modules/Core/Common/test/itkDerefGTest.cxx

@@ -0,0 +1,48 @@
+/*=========================================================================
+ *
+ *  Copyright NumFOCUS
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *         https://www.apache.org/licenses/LICENSE-2.0.txt
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *=========================================================================*/
+
+// First include the header file to be tested:
+#include "itkDeref.h"
+#include <gtest/gtest.h>
+#include "itkObject.h"
+
+
+// Tests that `Deref(ptr)` throws a `DerefError` exception when its argument is null.
+TEST(Deref, ThrowsExceptionWhenArgumentIsNull)
+{
+  const auto check = [](const auto & ptr) { EXPECT_THROW(itk::Deref(ptr), itk::DerefError); };
+
+  check(static_cast<int *>(nullptr));
+  check(static_cast<const int *>(nullptr));
+  check(static_cast<itk::Object *>(nullptr));
+}
+
+
+// Tests that `Deref(ptr)` returns the same reference as `*ptr`, when `ptr` is not null.
+TEST(Deref, ReturnsReferenceWhenArgumentIsNotNull)
+{
+  const auto check = [](const auto & ptr) {
+    const auto & ref = itk::Deref(ptr);
+    EXPECT_EQ(&ref, &*ptr);
+  };
+
+  constexpr int i{};
+  check(&i);
+  check(std::make_unique<int>().get());
+  check(itk::Object::New().get());
+}

Modules/IO/MeshVTK/test/itkVTKPolyDataMeshIOGTest.cxx

@@ -19,6 +19,7 @@
 // First include the header file to be tested:
 #include "itkMeshFileReader.h"
 
+#include "itkDeref.h"
 #include "itkMesh.h"
 #include "itkMeshFileWriter.h"
 #include "itkVTKPolyDataMeshIO.h"
@@ -53,9 +54,8 @@ Expect_lossless_writing_and_reading_of_points(const std::string &
 {
   const auto inputMesh = TMesh::New();
 
-  const auto inputPoints = inputMesh->GetPoints();
-  ASSERT_NE(inputPoints, nullptr);
-  inputPoints->assign(points.cbegin(), points.cend());
+  auto & inputPoints = itk::Deref(inputMesh->GetPoints());
+  inputPoints.assign(points.cbegin(), points.cend());
 
   const auto writer = itk::MeshFileWriter<TMesh>::New();
   if (writeAsBinary)
@@ -76,18 +76,16 @@ Expect_lossless_writing_and_reading_of_points(const std::string &
   reader->SetMeshIO(itk::VTKPolyDataMeshIO::New());
   reader->Update();
 
-  const auto outputMesh = reader->GetOutput();
-  ASSERT_NE(outputMesh, nullptr);
-  const auto outputPoints = outputMesh->GetPoints();
-  ASSERT_NE(outputPoints, nullptr);
+  const auto & outputMesh = itk::Deref(reader->GetOutput());
+  const auto & outputPoints = itk::Deref(outputMesh.GetPoints());
 
   const size_t expectedNumberOfPoints = points.size();
 
-  EXPECT_EQ(outputPoints->size(), expectedNumberOfPoints);
+  EXPECT_EQ(outputPoints.size(), expectedNumberOfPoints);
 
   auto pointIterator = points.cbegin();
 
-  for (const auto & outputPoint : *outputPoints)
+  for (const auto & outputPoint : outputPoints)
   {
     const auto & expectedPoint = *pointIterator;