MergeError
==========

.. cpp:class:: pandas::MergeError

   pandas C++ class.

Example
-------

.. code-block:: cpp

   #include <pandas/pandas.h>
   using namespace pandas;

   // Use MergeError
   MergeError obj;
   // ... operations ...

Constructors
------------

.. list-table::
   :widths: 55 25 20
   :header-rows: 1

   * - Signature
     - Location
     - Example
   * - ``explicit MergeError(const std::string& msg) : std::invalid_argument(msg)``
     - pd_exceptions.h:84
     - :ref:`View <example-mergeerror-mergeerror-0>`
   * - ``explicit MergeError(const char\* msg) : std::invalid_argument(msg)``
     - pd_exceptions.h:85
     - :ref:`View <example-mergeerror-mergeerror-1>`


Code Examples
-------------

The following examples are extracted from the test suite.

.. _example-mergeerror-mergeerror-0:

.. dropdown:: MergeError (pd_test_5_all.cpp:73286)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 73276
      :emphasize-lines: 11

          std::cout << "-- case_9_merge_error_typed_throw\n";
          static_assert(std::is_base_of_v<std::invalid_argument, pandas::MergeError>,
                        "pandas::MergeError must inherit std::invalid_argument");
          static_assert(std::is_base_of_v<std::exception, pandas::MergeError>,
                        "pandas::MergeError must inherit std::exception");
      
          // Round-trip via constant.
          {
              std::string caught;
              try {
                  throw pandas::MergeError(
                      std::string(pandas::error_messages::kMergeKeysNotUniqueLeftOneToOne));
              } catch (const std::exception& e) {
                  caught = e.what();
              }
              check_eq_str(
                  "case_9.MergeError_round_trip_constant",
                  "Merge keys are not unique in left dataset; not a one-to-one merge",
                  caught,
                  local_fail);
          }

.. _example-mergeerror-mergeerror-1:

.. dropdown:: MergeError (pd_test_5_all.cpp:73286)
   :class-title: example-dropdown

   .. code-block:: cpp
      :linenos:
      :lineno-start: 73276
      :emphasize-lines: 11

          std::cout << "-- case_9_merge_error_typed_throw\n";
          static_assert(std::is_base_of_v<std::invalid_argument, pandas::MergeError>,
                        "pandas::MergeError must inherit std::invalid_argument");
          static_assert(std::is_base_of_v<std::exception, pandas::MergeError>,
                        "pandas::MergeError must inherit std::exception");
      
          // Round-trip via constant.
          {
              std::string caught;
              try {
                  throw pandas::MergeError(
                      std::string(pandas::error_messages::kMergeKeysNotUniqueLeftOneToOne));
              } catch (const std::exception& e) {
                  caught = e.what();
              }
              check_eq_str(
                  "case_9.MergeError_round_trip_constant",
                  "Merge keys are not unique in left dataset; not a one-to-one merge",
                  caught,
                  local_fail);
          }