CArcStringList.h

// +---------------------------------------------------------------------------------------------------------+
// |  FILE:  CArcStringList.h                                                                                |
// +---------------------------------------------------------------------------------------------------------+
// |  PURPOSE: This file defines a string list class.                                                        |
// |                                                                                                         |
// |  AUTHOR:  Scott Streit         DATE: July 16, 2013                                                      |
// |                                                                                                         |
// |  Copyright 2013 Astronomical Research Cameras, Inc. All rights reserved.                                |
// +---------------------------------------------------------------------------------------------------------+
#pragma once
 
#ifdef _WINDOWS
    #pragma warning( disable: 4251 )
#endif
 
#include <initializer_list>
#include <algorithm>
#include <functional>
#include <utility>
#include <cstdint>
#include <ranges>
#include <memory>
#include <vector>
#include <string>
 
#include <CArcBaseDllMain.h>
 
 
 
namespace arc
{
    namespace gen4
    {
 
        // +-----------------------------------------------------------------------------------------------------+
        // |  CArcStringList Class                                                                               |
        // +-----------------------------------------------------------------------------------------------------+
 
        class GEN4_CARCBASE_API CArcStringList
        {
 
            public:
 
                typedef std::vector<std::string>::iterator          iterator;           
                typedef std::vector<std::string>::const_iterator    const_iterator;     
                CArcStringList( void );
 
                CArcStringList( const std::initializer_list<std::string>& tList );
 
                CArcStringList( const CArcStringList& tObj );
 
                CArcStringList( CArcStringList&& tObj ) noexcept;
 
                CArcStringList& operator=( const CArcStringList& tObj );
 
                CArcStringList& operator=( CArcStringList&& tObj ) noexcept;
 
                virtual ~CArcStringList( void ) = default;
 
                void add( std::string const& sElem );
 
                void clear( void );
 
                bool empty( void );
 
                const std::string toString( void );
 
                const std::string& at( std::uint32_t uIndex );
 
                bool find( const std::string& searchString ) noexcept;
 
                std::uint32_t length( void ) noexcept;
 
                CArcStringList& operator<<( std::string const& sElem );
 
                CArcStringList& operator+=( CArcStringList& anotherList );
 
                iterator begin( void ) noexcept;
 
                const_iterator cbegin( void ) noexcept;
 
                iterator end( void ) noexcept;
 
                const_iterator cend( void ) noexcept;
 
                void sortAscending( void );
 
                void sortDescending( void );
 
            private:
 
                std::unique_ptr<std::vector<std::string>> m_pvList;
        };
 
 
        using pStringList_t = std::unique_ptr<arc::gen4::CArcStringList>;
 
 
    }   // end gen4 namespace
}       // end arc namespace