QueryParams.hpp

Go to the documentation of this file.

#pragma once
#include <expected>
#include <format>
#include <vector>
#include <string>
 
#include <Thoth/Dsa/LinearMap.hpp>
#include <Thoth/Http/RequestError.hpp>
 
namespace Thoth::Http{
    struct QueryParams {
        using QueryKey      = std::string;
        using QueryKeyRef   = std::string_view;
 
        using QueryValue    = std::string;
        using QueryValueRef = std::string_view;
        using QueryValues   = std::vector<QueryValue>;
 
        using QueryPair     = std::pair<QueryKey, QueryValues>;
        // using MapType       = std::map<QueryKey, QueryValues, std::less<>>;
        using MapType       = Dsa::LinearMap<QueryKey, QueryValues>;
 
        using IterType      = decltype(MapType().begin());
        using CIterType     = decltype(MapType().cbegin());
 
 
        explicit QueryParams(const MapType& initAs);
 
        QueryParams(std::initializer_list<QueryPair> init);
 
 
        static QueryParams Parse(std::string_view paramsStr);
        static std::expected<QueryParams, RequestError> ParseDecodified(std::string_view str);
 
 
        [[nodiscard]] bool Exists(QueryKeyRef key) const;
 
        [[nodiscard]] bool ValExists(QueryKeyRef key, QueryValueRef val) const;
 
        void Add(QueryKeyRef key, QueryValue val);
 
        bool Remove(QueryKeyRef key, QueryValueRef val);
 
        bool RemoveKey(QueryKeyRef key);
 
        bool SetIfNull(QueryKeyRef key, QueryValueRef value);
        std::optional<QueryValues*> Get(QueryKeyRef key);
 
 
        IterType begin();
        IterType end();
        [[nodiscard]] CIterType begin() const;
        [[nodiscard]] CIterType end() const;
 
 
        void Clear();
 
        [[nodiscard]] size_t Size() const;
 
        [[nodiscard]] bool Empty() const;
 
        QueryValues& operator[](QueryKeyRef key);
 
        bool operator==(const QueryParams& other) const;
    private:
        MapType _elements;
 
        friend struct std::formatter<QueryParams>;
        friend struct std::hash<QueryParams>;
    };
}
 
 
#include <Thoth/Http/Request/QueryParams.tpp>