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

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

#ifndef LS_STD_INTEGER_HPP
#define LS_STD_INTEGER_HPP

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

/*
 * @doc: class(name: 'Integer', package: 'boxing')
 * @doc: boxing.Integer.description('This class represents the primitive datatype int and provides functionalities for arithmetic operations and string representation.')
 * */

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

      explicit Integer(int _value);
      Integer();
      ~Integer() noexcept override;

      // assignment operators

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

      // arithmetic operators

      int operator-() const;
      int operator+(const ls::standard::boxing::Integer &_integer) const;
      int operator+(int _value) const;
      int operator*(const ls::standard::boxing::Integer &_integer) const;
      int operator*(int _value) const;
      int operator-(const ls::standard::boxing::Integer &_integer) const;
      int operator-(int _value) const;
      int operator/(const ls::standard::boxing::Integer &_integer) const;
      int operator/(int _value) const;
      int operator%(const ls::standard::boxing::Integer &_integer) const;
      int operator%(int _value) const;

      // compound operators

      ls::standard::boxing::Integer &operator+=(const ls::standard::boxing::Integer &_integer);
      ls::standard::boxing::Integer &operator+=(int _value);
      ls::standard::boxing::Integer &operator-=(const ls::standard::boxing::Integer &_integer);
      ls::standard::boxing::Integer &operator-=(int _value);
      ls::standard::boxing::Integer &operator*=(const ls::standard::boxing::Integer &_integer);
      ls::standard::boxing::Integer &operator*=(int _value);
      ls::standard::boxing::Integer &operator/=(const ls::standard::boxing::Integer &_integer);
      ls::standard::boxing::Integer &operator/=(int _value);

      // comparison operators

      bool operator==(const ls::standard::boxing::Integer &_integer) const;
      bool operator==(int _value) const;
      bool operator!=(const ls::standard::boxing::Integer &_integer) const;
      bool operator!=(int _value) const;
      bool operator>(const ls::standard::boxing::Integer &_integer) const;
      bool operator>(int _value) const;
      bool operator>=(const ls::standard::boxing::Integer &_integer) const;
      bool operator>=(int _value) const;
      bool operator<(const ls::standard::boxing::Integer &_integer) const;
      bool operator<(int _value) const;
      bool operator<=(const ls::standard::boxing::Integer &_integer) const;
      bool operator<=(int _value) const;

      // logical operators

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

      // increment / decrement operator

      void operator++();
      void operator--();

      // implementation

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

      // additional functionality

      [[nodiscard]] int getValue() const;

    private:

      int value{};

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

#endif