Code/Engine/Foundation/Strings/Implementation/StringView.cpp - dev - redgpu/ezEngine

Code/Engine/Foundation/Strings/Implementation/StringView.cpp
324 строки9 KB
Jan Krassnigg
ezFoundation improvements (#1269)
18 апр 2024, 14:17
18 апр 2024, 14:1723e2663
#include <Foundation/FoundationPCH.h>

#include <Foundation/Strings/StringBuilder.h>
#include <Foundation/Strings/StringUtils.h>
#include <Foundation/Strings/StringView.h>

ezUInt32 ezStringView::GetCharacter() const
{
  if (!IsValid())
    return 0;

  return ezUnicodeUtils::ConvertUtf8ToUtf32(m_pStart);
}

const char* ezStringView::GetData(ezStringBuilder& ref_sTempStorage) const
{
  ref_sTempStorage = *this;
  return ref_sTempStorage.GetData();
}

bool ezStringView::IsEqualN(ezStringView sOther, ezUInt32 uiCharsToCompare) const
{
  return ezStringUtils::IsEqualN(GetStartPointer(), sOther.GetStartPointer(), uiCharsToCompare, GetEndPointer(), sOther.GetEndPointer());
}

bool ezStringView::IsEqualN_NoCase(ezStringView sOther, ezUInt32 uiCharsToCompare) const
{
  return ezStringUtils::IsEqualN_NoCase(GetStartPointer(), sOther.GetStartPointer(), uiCharsToCompare, GetEndPointer(), sOther.GetEndPointer());
}

ezInt32 ezStringView::Compare(ezStringView sOther) const
{
  return ezStringUtils::Compare(GetStartPointer(), sOther.GetStartPointer(), GetEndPointer(), sOther.GetEndPointer());
}

ezInt32 ezStringView::CompareN(ezStringView sOther, ezUInt32 uiCharsToCompare) const
{
  return ezStringUtils::CompareN(GetStartPointer(), sOther.GetStartPointer(), uiCharsToCompare, GetEndPointer(), sOther.GetEndPointer());
}

ezInt32 ezStringView::Compare_NoCase(ezStringView sOther) const
{
  return ezStringUtils::Compare_NoCase(GetStartPointer(), sOther.GetStartPointer(), GetEndPointer(), sOther.GetEndPointer());
}

ezInt32 ezStringView::CompareN_NoCase(ezStringView sOther, ezUInt32 uiCharsToCompare) const
{
  return ezStringUtils::CompareN_NoCase(GetStartPointer(), sOther.GetStartPointer(), uiCharsToCompare, GetEndPointer(), sOther.GetEndPointer());
}

const char* ezStringView::ComputeCharacterPosition(ezUInt32 uiCharacterIndex) const
{
  const char* pos = GetStartPointer();
  if (ezUnicodeUtils::MoveToNextUtf8(pos, GetEndPointer(), uiCharacterIndex).Failed())
    return nullptr;

  return pos;
}

const char* ezStringView::FindSubString(ezStringView sStringToFind, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetStartPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindSubString(szStartSearchAt, sStringToFind.GetStartPointer(), GetEndPointer(), sStringToFind.GetEndPointer());
}

const char* ezStringView::FindSubString_NoCase(ezStringView sStringToFind, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetStartPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindSubString_NoCase(szStartSearchAt, sStringToFind.GetStartPointer(), GetEndPointer(), sStringToFind.GetEndPointer());
}

const char* ezStringView::FindLastSubString(ezStringView sStringToFind, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetEndPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindLastSubString(GetStartPointer(), sStringToFind.GetStartPointer(), szStartSearchAt, GetEndPointer(), sStringToFind.GetEndPointer());
}

const char* ezStringView::FindLastSubString_NoCase(ezStringView sStringToFind, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetEndPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindLastSubString_NoCase(GetStartPointer(), sStringToFind.GetStartPointer(), szStartSearchAt, GetEndPointer(), sStringToFind.GetEndPointer());
}

const char* ezStringView::FindWholeWord(const char* szSearchFor, ezStringUtils::EZ_CHARACTER_FILTER isDelimiterCB, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetStartPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindWholeWord(szStartSearchAt, szSearchFor, isDelimiterCB, GetEndPointer());
}

const char* ezStringView::FindWholeWord_NoCase(const char* szSearchFor, ezStringUtils::EZ_CHARACTER_FILTER isDelimiterCB, const char* szStartSearchAt /*= nullptr*/) const
{
  if (szStartSearchAt == nullptr)
    szStartSearchAt = GetStartPointer();

  EZ_ASSERT_DEV((szStartSearchAt >= GetStartPointer()) && (szStartSearchAt <= GetEndPointer()), "The given pointer to start searching at is not inside this strings valid range.");

  return ezStringUtils::FindWholeWord_NoCase(szStartSearchAt, szSearchFor, isDelimiterCB, GetEndPointer());
}

void ezStringView::Shrink(ezUInt32 uiShrinkCharsFront, ezUInt32 uiShrinkCharsBack)
{
  const char* pEnd = m_pStart + m_uiElementCount;

  while (IsValid() && (uiShrinkCharsFront > 0))
  {
    if (ezUnicodeUtils::MoveToNextUtf8(m_pStart, pEnd, 1).Failed())
    {
      *this = {};
      return;
    }

    --uiShrinkCharsFront;
  }

  while (IsValid() && (uiShrinkCharsBack > 0))
  {
    if (ezUnicodeUtils::MoveToPriorUtf8(pEnd, m_pStart, 1).Failed())
    {
      *this = {};
      return;
    }

    --uiShrinkCharsBack;
  }

  m_uiElementCount = static_cast<ezUInt32>(pEnd - m_pStart);
}

ezStringView ezStringView::GetShrunk(ezUInt32 uiShrinkCharsFront, ezUInt32 uiShrinkCharsBack) const
{
  ezStringView tmp = *this;
  tmp.Shrink(uiShrinkCharsFront, uiShrinkCharsBack);
  return tmp;
}

ezStringView ezStringView::GetSubString(ezUInt32 uiFirstCharacter, ezUInt32 uiNumCharacters) const
{
  if (!IsValid())
  {
    return {};
  }

  const char* pEnd = m_pStart + m_uiElementCount;

  const char* pSubStart = m_pStart;
  if (ezUnicodeUtils::MoveToNextUtf8(pSubStart, pEnd, uiFirstCharacter).Failed() || pSubStart == pEnd)
  {
    return {};
  }

  const char* pSubEnd = pSubStart;
  ezUnicodeUtils::MoveToNextUtf8(pSubEnd, pEnd, uiNumCharacters).IgnoreResult(); // if it fails, it just points to the end

  return ezStringView(pSubStart, pSubEnd);
}

void ezStringView::ChopAwayFirstCharacterUtf8()
{
  if (IsValid())
  {
    const char* pEnd = m_pStart + m_uiElementCount;
    ezUnicodeUtils::MoveToNextUtf8(m_pStart, pEnd, 1).AssertSuccess();
    m_uiElementCount = static_cast<ezUInt32>(pEnd - m_pStart);
  }
}

void ezStringView::ChopAwayFirstCharacterAscii()
{
  if (IsValid())
  {
    EZ_ASSERT_DEBUG(ezUnicodeUtils::IsASCII(*m_pStart), "ChopAwayFirstCharacterAscii() was called on a non-ASCII character.");

    m_pStart += 1;
    m_uiElementCount--;
  }
}

bool ezStringView::TrimWordStart(ezStringView sWord)
{
  const bool bTrimAll = false;

  bool trimmed = false;

  do
  {
    if (!sWord.IsEmpty() && StartsWith_NoCase(sWord))
    {
      Shrink(ezStringUtils::GetCharacterCount(sWord.GetStartPointer(), sWord.GetEndPointer()), 0);
      trimmed = true;
    }

  } while (bTrimAll);

  return trimmed;
}

bool ezStringView::TrimWordEnd(ezStringView sWord)
{
  const bool bTrimAll = false;

  bool trimmed = false;

  do
  {
    if (!sWord.IsEmpty() && EndsWith_NoCase(sWord))
    {
      Shrink(0, ezStringUtils::GetCharacterCount(sWord.GetStartPointer(), sWord.GetEndPointer()));
      trimmed = true;
    }

  } while (bTrimAll);

  return trimmed;
}

ezStringView::iterator ezStringView::GetIteratorFront() const
{
  return begin(*this);
}

ezStringView::reverse_iterator ezStringView::GetIteratorBack() const
{
  return rbegin(*this);
}

bool ezStringView::HasAnyExtension() const
{
  return ezPathUtils::HasAnyExtension(*this);
}

bool ezStringView::HasExtension(ezStringView sExtension) const
{
  return ezPathUtils::HasExtension(*this, sExtension);
}

ezStringView ezStringView::GetFileExtension(bool bFullExtension /*= false*/) const
{
  return ezPathUtils::GetFileExtension(*this, bFullExtension);
}

ezStringView ezStringView::GetFileName() const
{
  return ezPathUtils::GetFileName(*this);
}

ezStringView ezStringView::GetFileNameAndExtension() const
{
  return ezPathUtils::GetFileNameAndExtension(*this);
}

ezStringView ezStringView::GetFileDirectory() const
{
  return ezPathUtils::GetFileDirectory(*this);
}

bool ezStringView::IsAbsolutePath() const
{
  return ezPathUtils::IsAbsolutePath(*this);
}

bool ezStringView::IsRelativePath() const
{
  return ezPathUtils::IsRelativePath(*this);
}

bool ezStringView::IsRootedPath() const
{
  return ezPathUtils::IsRootedPath(*this);
}

ezStringView ezStringView::GetRootedPathRootName() const
{
  return ezPathUtils::GetRootedPathRootName(*this);
}

#if EZ_ENABLED(EZ_INTEROP_STL_STRINGS)
ezStringView::ezStringView(const std::string_view& rhs)
{
  if (!rhs.empty())
  {
    m_pStart = rhs.data();
    m_uiElementCount = static_cast<ezUInt32>(rhs.size());
  }
}

ezStringView::ezStringView(const std::string& rhs)
{
  if (!rhs.empty())
  {
    m_pStart = rhs.data();
    m_uiElementCount = static_cast<ezUInt32>(rhs.size());
  }
}

std::string_view ezStringView::GetAsStdView() const
{
  return std::string_view(m_pStart, static_cast<size_t>(m_uiElementCount));
}

ezStringView::operator std::string_view() const
{
  return GetAsStdView();
}
#endif