ls-standard-library/include/ls-std/boxing/Boolean.hpp

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

#ifndef LS_STD_BOOLEAN_HPP
#define LS_STD_BOOLEAN_HPP

#include <ls-std/core/Class.hpp>
#include <ls-std/core/interface/IBoxing.hpp>
#include <ls-std/os/dynamic-goal.hpp>
#include <memory>
#include <sstream>

/*
 * @doc: class(name: 'Boolean', package: 'boxing')
 * @doc: boxing.Boolean.description('This class represents the primitive datatype bool and provides functionalities for boolean expressions and string representation.')
 * */

namespace ls::standard::boxing
{
  class LS_STD_DYNAMIC_GOAL Boolean : public ls::standard::core::Class, public ls::standard::core::interface_type::IBoxing
  {
    public:

      explicit Boolean(bool _value);
      Boolean();
      ~Boolean() noexcept override;

      // assignment operators

      ls::standard::boxing::Boolean &operator=(int _value);
      ls::standard::boxing::Boolean &operator=(bool _value);

      // stream operators

      friend ::std::ostream &operator<<(::std::ostream &_outputStream, const ls::standard::boxing::Boolean &_boolean)
      {
        _outputStream << _boolean._toString();
        return _outputStream;
      }

      // logical operators

      friend bool operator!(const ls::standard::boxing::Boolean &_boolean)
      {
        return !_boolean.value;
      }

      bool operator&&(const ls::standard::boxing::Boolean &_boolean) const;
      bool operator&&(bool _value) const;
      bool operator&&(int _value) const;
      bool operator||(const ls::standard::boxing::Boolean &_boolean) const;
      bool operator||(bool _value) const;
      bool operator||(int _value) const;
      // INFO: operator ^ can not be taken for XOR, since it's not possible to implement it respecting commutative law

      // implementation

      void parse(const ::std::string &_parseText) override;
      [[nodiscard]] ::std::string toString() override;

      // additional functionality

      [[nodiscard]] bool getValue() const;
      [[nodiscard]] static bool XOR(const ls::standard::boxing::Boolean &_leftExpression, const ls::standard::boxing::Boolean &_rightExpression);
      [[nodiscard]] static bool XOR(const ls::standard::boxing::Boolean &_leftExpression, bool _rightExpression);
      [[nodiscard]] static bool XOR(bool _leftExpression, const ls::standard::boxing::Boolean &_rightExpression);
      [[nodiscard]] static bool XOR(bool _leftExpression, bool _rightExpression);

    private:

      bool value{};

      const ::std::string FALSE_STRING = "false";
      const ::std::string TRUE_STRING = "true";

      [[nodiscard]] static ::std::string _fetchClassName();
      [[nodiscard]] ::std::string _toString() const;
  };
}

#endif