BLI_string_ref.hh

Go to the documentation of this file.

/*
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */
 
#pragma once
 
#include <cstring>
#include <sstream>
#include <string>
#include <string_view>
 
#include "BLI_span.hh"
#include "BLI_utildefines.h"
 
namespace blender {
 
class StringRef;
 
class StringRefBase {
 protected:
  const char *data_;
  int64_t size_;
 
  constexpr StringRefBase(const char *data, const int64_t size) : data_(data), size_(size)
  {
  }
 
 public:
  /* Similar to string_view::npos, but signed. */
  static constexpr int64_t not_found = -1;
 
  constexpr int64_t size() const
  {
    return size_;
  }
 
  constexpr bool is_empty() const
  {
    return size_ == 0;
  }
 
  constexpr const char *data() const
  {
    return data_;
  }
 
  constexpr operator Span<char>() const
  {
    return Span<char>(data_, size_);
  }
 
  operator std::string() const
  {
    return std::string(data_, static_cast<size_t>(size_));
  }
 
  constexpr operator std::string_view() const
  {
    return std::string_view(data_, static_cast<size_t>(size_));
  }
 
  constexpr const char *begin() const
  {
    return data_;
  }
 
  constexpr const char *end() const
  {
    return data_ + size_;
  }
 
  constexpr IndexRange index_range() const
  {
    return IndexRange(size_);
  }
 
  void unsafe_copy(char *dst) const
  {
    memcpy(dst, data_, static_cast<size_t>(size_));
    dst[size_] = '\0';
  }
 
  void copy(char *dst, const int64_t dst_size) const
  {
    if (size_ < dst_size) {
      this->unsafe_copy(dst);
    }
    else {
      BLI_assert(false);
      dst[0] = '\0';
    }
  }
 
  template<size_t N> void copy(char (&dst)[N]) const
  {
    this->copy(dst, N);
  }
 
  constexpr bool startswith(StringRef prefix) const;
 
  constexpr bool endswith(StringRef suffix) const;
 
  constexpr StringRef substr(int64_t start, const int64_t size) const;
 
  constexpr const char &front() const
  {
    BLI_assert(size_ >= 1);
    return data_[0];
  }
 
  constexpr const char &back() const
  {
    BLI_assert(size_ >= 1);
    return data_[size_ - 1];
  }
 
  constexpr int64_t find(char c, int64_t pos = 0) const;
  constexpr int64_t find(StringRef str, int64_t pos = 0) const;
  constexpr int64_t rfind(char c, int64_t pos = INT64_MAX) const;
  constexpr int64_t rfind(StringRef str, int64_t pos = INT64_MAX) const;
  constexpr int64_t find_first_of(StringRef chars, int64_t pos = 0) const;
  constexpr int64_t find_first_of(char c, int64_t pos = 0) const;
  constexpr int64_t find_last_of(StringRef chars, int64_t pos = INT64_MAX) const;
  constexpr int64_t find_last_of(char c, int64_t pos = INT64_MAX) const;
  constexpr int64_t find_first_not_of(StringRef chars, int64_t pos = 0) const;
  constexpr int64_t find_first_not_of(char c, int64_t pos = 0) const;
  constexpr int64_t find_last_not_of(StringRef chars, int64_t pos = INT64_MAX) const;
  constexpr int64_t find_last_not_of(char c, int64_t pos = INT64_MAX) const;
};
 
class StringRefNull : public StringRefBase {
 
 public:
  constexpr StringRefNull() : StringRefBase("", 0)
  {
  }
 
  StringRefNull(const char *str) : StringRefBase(str, static_cast<int64_t>(strlen(str)))
  {
    BLI_assert(str != nullptr);
    BLI_assert(data_[size_] == '\0');
  }
 
  constexpr StringRefNull(const char *str, const int64_t size) : StringRefBase(str, size)
  {
    BLI_assert(static_cast<int64_t>(strlen(str)) == size);
  }
 
  StringRefNull(const std::string &str) : StringRefNull(str.c_str())
  {
  }
 
  constexpr char operator[](const int64_t index) const
  {
    BLI_assert(index >= 0);
    /* Use '<=' instead of just '<', so that the null character can be accessed as well. */
    BLI_assert(index <= size_);
    return data_[index];
  }
 
  constexpr const char *c_str() const
  {
    return data_;
  }
};
 
class StringRef : public StringRefBase {
 public:
  constexpr StringRef() : StringRefBase(nullptr, 0)
  {
  }
 
  constexpr StringRef(StringRefNull other) : StringRefBase(other.data(), other.size())
  {
  }
 
  constexpr StringRef(const char *str)
      : StringRefBase(str, str ? static_cast<int64_t>(std::char_traits<char>::length(str)) : 0)
  {
  }
 
  constexpr StringRef(const char *str, const int64_t length) : StringRefBase(str, length)
  {
  }
 
  constexpr StringRef(const char *begin, const char *one_after_end)
      : StringRefBase(begin, static_cast<int64_t>(one_after_end - begin))
  {
    BLI_assert(begin <= one_after_end);
  }
 
  StringRef(const std::string &str) : StringRefBase(str.data(), static_cast<int64_t>(str.size()))
  {
  }
 
  constexpr StringRef(std::string_view view)
      : StringRefBase(view.data(), static_cast<int64_t>(view.size()))
  {
  }
 
  constexpr StringRef drop_prefix(const int64_t n) const
  {
    BLI_assert(n >= 0);
    const int64_t clamped_n = std::min(n, size_);
    const int64_t new_size = size_ - clamped_n;
    return StringRef(data_ + clamped_n, new_size);
  }
 
  constexpr StringRef drop_known_prefix(StringRef prefix) const
  {
    BLI_assert(this->startswith(prefix));
    return this->drop_prefix(prefix.size());
  }
 
  constexpr StringRef drop_suffix(const int64_t n) const
  {
    BLI_assert(n >= 0);
    const int64_t new_size = std::max<int64_t>(0, size_ - n);
    return StringRef(data_, new_size);
  }
 
  constexpr char operator[](int64_t index) const
  {
    BLI_assert(index >= 0);
    BLI_assert(index < size_);
    return data_[index];
  }
};
 
/* More inline functions
 ***************************************/
 
inline std::ostream &operator<<(std::ostream &stream, StringRef ref)
{
  stream << std::string(ref);
  return stream;
}
 
inline std::ostream &operator<<(std::ostream &stream, StringRefNull ref)
{
  stream << std::string(ref.data(), (size_t)ref.size());
  return stream;
}
 
inline std::string operator+(StringRef a, StringRef b)
{
  return std::string(a) + std::string(b);
}
 
/* This does not compare StringRef and std::string_view, because of ambiguous overloads. This is
 * not a problem when std::string_view is only used at api boundaries. To compare a StringRef and a
 * std::string_view, one should convert the std::string_view to StringRef (which is very cheap).
 * Ideally, we only use StringRef in our code to avoid this problem altogether. */
constexpr inline bool operator==(StringRef a, StringRef b)
{
  if (a.size() != b.size()) {
    return false;
  }
  return STREQLEN(a.data(), b.data(), (size_t)a.size());
}
 
constexpr inline bool operator!=(StringRef a, StringRef b)
{
  return !(a == b);
}
 
constexpr inline bool operator<(StringRef a, StringRef b)
{
  return std::string_view(a) < std::string_view(b);
}
 
constexpr inline bool operator>(StringRef a, StringRef b)
{
  return std::string_view(a) > std::string_view(b);
}
 
constexpr inline bool operator<=(StringRef a, StringRef b)
{
  return std::string_view(a) <= std::string_view(b);
}
 
constexpr inline bool operator>=(StringRef a, StringRef b)
{
  return std::string_view(a) >= std::string_view(b);
}
 
constexpr inline bool StringRefBase::startswith(StringRef prefix) const
{
  if (size_ < prefix.size_) {
    return false;
  }
  for (int64_t i = 0; i < prefix.size_; i++) {
    if (data_[i] != prefix.data_[i]) {
      return false;
    }
  }
  return true;
}
 
constexpr inline bool StringRefBase::endswith(StringRef suffix) const
{
  if (size_ < suffix.size_) {
    return false;
  }
  const int64_t offset = size_ - suffix.size_;
  for (int64_t i = 0; i < suffix.size_; i++) {
    if (data_[offset + i] != suffix.data_[i]) {
      return false;
    }
  }
  return true;
}
 
constexpr inline StringRef StringRefBase::substr(const int64_t start,
                                                 const int64_t max_size = INT64_MAX) const
{
  BLI_assert(max_size >= 0);
  BLI_assert(start >= 0);
  const int64_t substr_size = std::min(max_size, size_ - start);
  return StringRef(data_ + start, substr_size);
}
 
constexpr inline int64_t index_or_npos_to_int64(size_t index)
{
  /* The compiler will probably optimize this check away. */
  if (index == std::string_view::npos) {
    return StringRef::not_found;
  }
  return static_cast<int64_t>(index);
}
 
constexpr inline int64_t StringRefBase::find(char c, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(std::string_view(*this).find(c, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find(StringRef str, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(std::string_view(*this).find(str, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find_first_of(StringRef chars, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(
      std::string_view(*this).find_first_of(chars, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find_first_of(char c, int64_t pos) const
{
  return this->find_first_of(StringRef(&c, 1), pos);
}
 
constexpr inline int64_t StringRefBase::find_last_of(StringRef chars, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(
      std::string_view(*this).find_last_of(chars, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find_last_of(char c, int64_t pos) const
{
  return this->find_last_of(StringRef(&c, 1), pos);
}
 
constexpr inline int64_t StringRefBase::find_first_not_of(StringRef chars, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(
      std::string_view(*this).find_first_not_of(chars, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find_first_not_of(char c, int64_t pos) const
{
  return this->find_first_not_of(StringRef(&c, 1), pos);
}
 
constexpr inline int64_t StringRefBase::find_last_not_of(StringRef chars, int64_t pos) const
{
  BLI_assert(pos >= 0);
  return index_or_npos_to_int64(
      std::string_view(*this).find_last_not_of(chars, static_cast<size_t>(pos)));
}
 
constexpr inline int64_t StringRefBase::find_last_not_of(char c, int64_t pos) const
{
  return this->find_last_not_of(StringRef(&c, 1), pos);
}
 
}  // namespace blender