IndexBuilder
============

.. cpp:class:: numpy::IndexBuilder

   numpy C++ class.

Example
-------

.. code-block:: cpp

   #include <numpy/np_ndarray.h>
   using namespace numpy;

   // Use IndexBuilder
   IndexBuilder obj;
   // ... operations ...

Math Operations
---------------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``IndexBuilder & add(ssize_tidx)``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:297
     - :ref:`View <example-indexbuilder-add-0>`
   * - ``IndexBuilder & add(const Slice &slice)``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:298
     - :ref:`View <example-indexbuilder-add-1>`
   * - ``IndexBuilder & add(const NDArray<T>&array)``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:303
     - :ref:`View <example-indexbuilder-add-2>`
   * - ``IndexBuilder & add_all()``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:299
     - 
   * - ``IndexBuilder & add_ellipsis()``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:300
     - 
   * - ``IndexBuilder & add_newaxis()``
     - IndexBuilder &
     - NP_INDEX_TYPES.H:301
     - 

Other Methods
-------------

.. list-table::
   :widths: 40 20 15 25
   :header-rows: 1

   * - Signature
     - Return Type
     - Location
     - Example
   * - ``IndexExpr build()``
     - IndexExpr
     - NP_INDEX_TYPES.H:309
     - 


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

The following examples are extracted from the test suite.

.. _example-indexbuilder-add-0:

.. dropdown:: add (np_test_1_all.cpp:6410)
   :class-title: example-dropdown

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

      void testCharArrayStringOperationsCharArray() {
          std::cout << "========= testStringOperations =======================";
      
          // Test string concatenation
          std::vector<std::string> words1 = {"Hello", "Good", "Nice"};
          std::vector<std::string> words2 = {" World", " Day", " Work"};
      
          auto arr1 = array<32>(words1);
          auto arr2 = array<32>(words2);
      
          auto result = add(arr1, arr2);
          // std::cout << "String concatenation (add):" << std::endl;
          for (size_t i = 0; i < result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '" << arr2[i] << "' = '" << result[i] << "'";
          }
      
          // Test scalar addition
          auto scalar_result = add(arr1, "!");
          // std::cout << "Scalar concatenation:" << std::endl;
          for (size_t i = 0; i < scalar_result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '!' = '" << scalar_result[i] << "'";

.. _example-indexbuilder-add-1:

.. dropdown:: add (np_test_1_all.cpp:6410)
   :class-title: example-dropdown

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

      void testCharArrayStringOperationsCharArray() {
          std::cout << "========= testStringOperations =======================";
      
          // Test string concatenation
          std::vector<std::string> words1 = {"Hello", "Good", "Nice"};
          std::vector<std::string> words2 = {" World", " Day", " Work"};
      
          auto arr1 = array<32>(words1);
          auto arr2 = array<32>(words2);
      
          auto result = add(arr1, arr2);
          // std::cout << "String concatenation (add):" << std::endl;
          for (size_t i = 0; i < result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '" << arr2[i] << "' = '" << result[i] << "'";
          }
      
          // Test scalar addition
          auto scalar_result = add(arr1, "!");
          // std::cout << "Scalar concatenation:" << std::endl;
          for (size_t i = 0; i < scalar_result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '!' = '" << scalar_result[i] << "'";

.. _example-indexbuilder-add-2:

.. dropdown:: add (np_test_1_all.cpp:6410)
   :class-title: example-dropdown

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

      void testCharArrayStringOperationsCharArray() {
          std::cout << "========= testStringOperations =======================";
      
          // Test string concatenation
          std::vector<std::string> words1 = {"Hello", "Good", "Nice"};
          std::vector<std::string> words2 = {" World", " Day", " Work"};
      
          auto arr1 = array<32>(words1);
          auto arr2 = array<32>(words2);
      
          auto result = add(arr1, arr2);
          // std::cout << "String concatenation (add):" << std::endl;
          for (size_t i = 0; i < result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '" << arr2[i] << "' = '" << result[i] << "'";
          }
      
          // Test scalar addition
          auto scalar_result = add(arr1, "!");
          // std::cout << "Scalar concatenation:" << std::endl;
          for (size_t i = 0; i < scalar_result.size(); ++i) {
              // std::cout << "'" << arr1[i] << "' + '!' = '" << scalar_result[i] << "'";