ls-standard-library/include/ls-std/core/evaluator/RawNullPointerEvaluator.hpp

/*
* Author:          Patrick-Christopher Mattulat
* Co-Author:       Claude Sonnet 4.6 (LLM)
* Company:         Lynar Studios
* E-Mail:          webmaster@lynarstudios.com
* Created:         2023-05-24
* Changed:         2026-06-23
*
* */

#ifndef LS_STD_RAW_NULL_POINTER_EVALUATOR_HPP
#define LS_STD_RAW_NULL_POINTER_EVALUATOR_HPP

#include <ls-std/core/exception/NullPointerException.hpp>
#include <ls-std/core/interface/IEvaluator.hpp>
#include <ls-std/core/type/RawPointer.hpp>
#include <string>

/*
 * @doc: class(name: 'RawNullPointerEvaluator', package: 'core')
 * @doc: core.RawNullPointerEvaluator.description('This class evaluates whether a passed raw pointer reference is null.')
 * */

namespace ls::standard::core
{
  template<typename T>
  class RawNullPointerEvaluator : public ls::standard::core::interface_type::IEvaluator
  {
    public:

      explicit RawNullPointerEvaluator(const ls::standard::core::type::RawPointer<T> &_argument) : argument(_argument)
      {}
      RawNullPointerEvaluator(const ls::standard::core::type::RawPointer<T> &_argument, const ::std::string &_message) : argument(_argument), message(_message)
      {}
      ~RawNullPointerEvaluator() noexcept override = default;

      void evaluate() override
      {
        if (this->argument.get() == nullptr)
        {
          if (this->message.empty())
          {
            throw ls::standard::core::NullPointerException{"reference in use is null!"};
          }
          else
          {
            throw ls::standard::core::NullPointerException{this->message};
          }
        }
      }

    private:

      ls::standard::core::type::RawPointer<T> argument{};
      ::std::string message{};
  };
}

#endif