String.h

Go to the documentation of this file.

// Copyright Onix Solutions Limited [OnixS]. All rights reserved.
//
// This software owned by Onix Solutions Limited [OnixS] and is
// protected by copyright law and international copyright treaties.
//
// Access to and use of the software is governed by the terms of the applicable
// OnixS Software Services Agreement (the Agreement) and Customer end user license
// agreements granting a non-assignable, non-transferable and non-exclusive license
// to use the software for it's own data processing purposes under the terms defined
// in the Agreement.
//
// Except as otherwise granted within the terms of the Agreement, copying or
// reproduction of any part of this source code or associated reference material
// to any other location for further reproduction or redistribution, and any
// amendments to this copyright notice, are expressly prohibited.
//
// Any reproduction or redistribution for sale or hiring of the Software not in
// accordance with the terms of the Agreement is a violation of copyright law.
//
 
#pragma once
 
#include <OnixS/FmxUST/MarketData/Bimp/Compiler.h>
 
#include <cstddef>
#include <cstring>
#include <string>
#include <stdexcept>
 
#include <algorithm>
#include <ostream>
 
namespace OnixS
{
    namespace FmxUST
    {
        namespace MarketData
        {
            namespace Bimp
            {
                typedef char Char;

                class StrRef
                {
                public:
                    typedef const Char* Iterator;

                    StrRef()
                    ONIXS_FMXUST_BIMP_NOTHROW
                        : items_(ONIXS_FMXUST_BIMP_NULLPTR)
                        , size_(0)
                    {
                    }

                    StrRef(
                        const Char* chars,
                        size_t size)
                        ONIXS_FMXUST_BIMP_NOTHROW
                        : items_(chars)
                        , size_(size)
                    {
                    }
 
                    template <size_t Size>
                    explicit
                    ONIXS_FMXUST_BIMP_CONSTEXPR
                    StrRef(const char (&value)[Size])
                    ONIXS_FMXUST_BIMP_NOTHROW
                        : items_(value)
                        , size_(Size - 1)
                    {
                    }

                    StrRef(
                        const StrRef& other)
                        ONIXS_FMXUST_BIMP_NOTHROW
                        : items_(other.items_)
                        , size_(other.size_)
                    {
                    }

                    bool empty() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        return (0 == size_);
                    }

                    const Char* items() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        return items_;
                    }

                    size_t size() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        return size_;
                    }

                    Iterator begin() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        return items_;
                    }

                    Iterator end() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        return (items_ + size_);
                    }

                    void reset()
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        reset(ONIXS_FMXUST_BIMP_NULLPTR, 0);
                    }

                    void
                    reset(
                        const Char* chars,
                        size_t size)
                        ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        items_ = chars;
                        size_ = size;
                    }
 
                    const Char&
                    operator [](
                        size_t index) const
                    {
                        return items_[index];
                    }
 
                    const Char&
                    at(
                        size_t index) const
                    {
                        if (index < size_)
                            return items_[index];
 
                        throw std::invalid_argument("index");
                    }

                    StrRef&
                    operator =(
                        const StrRef& other)
                                ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        items_ = other.items_;
                        size_ = other.size_;
 
                        return *this;
                    }

                    void
                    swap(
                        StrRef& other)
                        ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        std::swap(items_, other.items_);
                        std::swap(size_, other.size_);
                    }
 
 
                    // Get trimmed presentation of the current string
                    StrRef trim() const
                    ONIXS_FMXUST_BIMP_NOTHROW
                    {
                        size_t length = size();
 
                        while(length > 0 && isspace(operator[](length - 1)))
                            --length;
 
                        return StrRef(items(), length);
                    }
 
                private:
                    const Char* items_;

                    size_t size_;
                };

                inline
                    StrRef
                    toStrRef(
                        const std::string& str)
                {
                    return StrRef(str.data(), str.size());
                }

                inline
                    StrRef
                    toStrRef(
                        const Char* cStr)
                {
                    return
                        StrRef(
                            cStr,
                            cStr
                            ? strlen(cStr)
                            : 0
                        );
                }

                inline
                    std::string
                    toStr(
                        const StrRef& ref)
                {
                    return std::string(ref.items(), ref.size());
                }

                inline
                    void
                    toStr(
                        std::string& str,
                        const StrRef& ref)
                {
                    str.append(ref.items(), ref.size());
                }

                inline
                    std::string
                    toStr(
                        Char character)
                {
                    return std::string(1, character);
                }

                inline
                    void
                    toStr(
                        std::string& str,
                        Char character)
                {
                    str.append(1, character);
                }

                inline
                    void
                    toStr(
                        std::string& str,
                        const std::string& value)
                {
                    str.append(value);
                }

                inline
                    bool
                    operator ==(
                        const StrRef& left,
                        const StrRef& right)
                {
                    return (
                        left.size() == right.size()
                        &&
                        0 == memcmp(
                            left.items(), right.items(), left.size()));
                }

                inline
                    bool
                    operator !=(
                        const StrRef& left,
                        const StrRef& right)
                {
                    return !(left == right);
                }

                inline
                    bool
                    operator ==(
                        const StrRef& ref,
                        const std::string& str)
                {
                    return ref == toStrRef(str);
                }

                inline
                    bool
                    operator !=(
                        const StrRef& ref,
                        const std::string& str)
                {
                    return ref != toStrRef(str);
                }

                inline
                    bool
                    operator ==(
                        const std::string& str,
                        const StrRef& ref)
                {
                    return ref == toStrRef(str);
                }

                inline
                    bool
                    operator !=(
                        const std::string& str,
                        const StrRef& ref)
                {
                    return ref != toStrRef(str);
                }

                inline
                    bool
                    operator ==(
                        const StrRef& ref,
                        const Char* str)
                {
                    return ref == toStrRef(str);
                }

                inline
                    bool
                    operator !=(
                        const StrRef& ref,
                        const Char* str)
                {
                    return ref != toStrRef(str);
                }

                inline
                    bool
                    operator ==(
                        const Char* str,
                        const StrRef& ref)
                {
                    return ref == toStrRef(str);
                }

                inline
                    bool
                    operator !=(
                        const Char* str,
                        const StrRef& ref)
                {
                    return ref != toStrRef(str);
                }

                inline
                    bool
                    operator <(
                        const StrRef& left,
                        const StrRef& right)
                {
                    ptrdiff_t
                        compareResult =
                        memcmp(
                            left.items(),
                            right.items(),
                            left.size() < right.size()
                            ? left.size()
                            : right.size());
 
                    if (0 == compareResult)
                    {
                        compareResult =
                            static_cast<ptrdiff_t>(
                                left.size() - right.size());
                    }
 
                    return (0 > compareResult);
                }

                inline
                    bool
                    operator >(
                        const StrRef& left,
                        const StrRef& right)
                {
                    return (right < left);
                }

                inline
                    std::ostream&
                    operator <<(
                        std::ostream& stream,
                        const StrRef& text)
                {
                    stream.write(text.items(), text.size());
 
                    return stream;
                }
 
            }
        }
    }
}