ls-standard-library/include/ls-std/core/exception/IndexOutOfBoundsException.hpp

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

#ifndef LS_STD_INDEX_OUT_OF_BOUNDS_EXCEPTION_HPP
#define LS_STD_INDEX_OUT_OF_BOUNDS_EXCEPTION_HPP

#include <ls-std/core/exception/Exception.hpp>
#include <ls-std/os/dynamic-goal.hpp>
#include <string>

/*
 * @doc: class(name: 'IndexOutOfBoundsException', package: 'core')
 * @doc: core.IndexOutOfBoundsException.description('This exception can be thrown in case an index of an array like structure is out of bounds.')
 * */

namespace ls::standard::core
{
  class LS_STD_DYNAMIC_GOAL IndexOutOfBoundsException : public ls::standard::core::Exception
  {
    public:

      IndexOutOfBoundsException();
      explicit IndexOutOfBoundsException(const ::std::string &_message);
      ~IndexOutOfBoundsException() noexcept override;

      [[nodiscard]] const char *what() const noexcept override;
  };
}

#endif