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 <cstddef>
#include <cstring>
#include <string>
#include <stdexcept>
 
#include <algorithm>
#include <ostream>
 
#include <OnixS/CME/MDH/Bootstrap.h>
 
ONIXS_CMEMDH_NAMESPACE_BEGIN

typedef char Char;

class ONIXS_CMEMDH_LTWT StrRef
{
public:
    typedef const Char* Iterator;

    StrRef()
        : items_(ONIXS_CMEMDH_NULLPTR)
        , size_(0)
    {
    }

    StrRef(const Char* chars, size_t size)
        : items_(chars)
        , size_(size)
    {
    }

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

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

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

    size_t size() const
    {
        return size_;
    }

    Iterator begin() const
    {
        return items_;
    }

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

    void reset()
    {
        reset(ONIXS_CMEMDH_NULLPTR, 0);
    }

    void reset(const Char* chars, size_t size)
    {
        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)
    {
        items_ = other.items_;
        size_ = other.size_;
 
        return *this;
    }

    void swap(StrRef& other)
    {
        std::swap(items_, other.items_);
 
        std::swap(size_, other.size_);
    }
 
private:
    // Items being referenced.
    const Char* items_;
 
    // Number of chars being referenced.
    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)
{
    const int result = memcmp(left.items(), right.items(), left.size() < right.size() ? left.size() : right.size());
 
    return (0 != result ? (0 > result) : (left.size() < right.size()));
}

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;
}
 
ONIXS_CMEMDH_NAMESPACE_END