iterator_example.cpp

Demonstrates the STL iterator interface on value_container:

• Range-based for loop syntax over container values
• STL algorithms: std::find_if, std::count_if, std::for_each
• Iterator properties: begin/end, cbegin/cend, size, empty

Category

Basic

See also

kcenon::container::value_container::iterator

kcenon::container::value_container::const_iterator

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#include "core/container.h"
#include <algorithm>
#include <iostream>
#include <numeric>
 
using namespace kcenon::container;
 
void demonstrate_range_based_for()
{
    std::cout << "\n=== Range-Based For Loop ===" << std::endl;
 
    value_container container;
 
    // Note: For demonstration, we're showing the concept
    // In actual use, you would populate the container with data
    std::cout << "Container size: " << container.size() << std::endl;
    std::cout << "Container empty: " << (container.empty() ? "yes" : "no") << std::endl;
 
    // Example of range-based for loop (when container has data)
    std::cout << "Range-based for loop syntax:" << std::endl;
    std::cout << "  for (const auto& value : container) {" << std::endl;
    std::cout << "      // Process each optimized_value" << std::endl;
    std::cout << "  }" << std::endl;
}
 
void demonstrate_stl_algorithms()
{
    std::cout << "\n=== STL Algorithms ===" << std::endl;
 
    value_container container;
 
    // Example 1: find_if
    std::cout << "find_if example:" << std::endl;
    std::cout << "  auto it = std::find_if(container.begin(), container.end()," << std::endl;
    std::cout << "      [](const optimized_value& val) {" << std::endl;
    std::cout << "          return val.type == value_types::int_value;" << std::endl;
    std::cout << "      });" << std::endl;
 
    // Example 2: count_if
    std::cout << "\ncount_if example:" << std::endl;
    std::cout << "  size_t count = std::count_if(container.begin(), container.end()," << std::endl;
    std::cout << "      [](const optimized_value& val) {" << std::endl;
    std::cout << "          return val.type == value_types::string_value;" << std::endl;
    std::cout << "      });" << std::endl;
 
    // Example 3: for_each
    std::cout << "\nfor_each example:" << std::endl;
    std::cout << "  std::for_each(container.begin(), container.end()," << std::endl;
    std::cout << "      [](const optimized_value& val) {" << std::endl;
    std::cout << "          std::cout << val.name << std::endl;" << std::endl;
    std::cout << "      });" << std::endl;
}
 
void demonstrate_iterator_properties()
{
    std::cout << "\n=== Iterator Properties ===" << std::endl;
 
    value_container container;
 
    std::cout << "Iterator methods available:" << std::endl;
    std::cout << "  container.begin()   - returns iterator to first element" << std::endl;
    std::cout << "  container.end()     - returns iterator to past-the-end" << std::endl;
    std::cout << "  container.cbegin()  - returns const_iterator to first element" << std::endl;
    std::cout << "  container.cend()    - returns const_iterator to past-the-end" << std::endl;
    std::cout << "  container.size()    - returns number of elements" << std::endl;
    std::cout << "  container.empty()   - returns true if empty" << std::endl;
 
    std::cout << "\nIterator types:" << std::endl;
    std::cout << "  using iterator = std::vector<optimized_value>::iterator;" << std::endl;
    std::cout << "  using const_iterator = std::vector<optimized_value>::const_iterator;" << std::endl;
}
 
int main()
{
    std::cout << "========================================" << std::endl;
    std::cout << "Container Iterator Support Examples" << std::endl;
    std::cout << "========================================" << std::endl;
 
    demonstrate_range_based_for();
    demonstrate_stl_algorithms();
    demonstrate_iterator_properties();
 
    std::cout << "\n========================================" << std::endl;
    std::cout << "Examples completed successfully!" << std::endl;
    std::cout << "========================================" << std::endl;
 
    return 0;
}