string_ref.cc

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2023 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

 
#include "BLI_string_ref.hh"
#include "BLI_string_utf8.h"
 
#include <ostream>
 
namespace blender {
 
std::ostream &operator<<(std::ostream &stream, StringRef ref)
{
  stream << std::string(ref);
  return stream;
}
 
std::ostream &operator<<(std::ostream &stream, StringRefNull ref)
{
  stream << std::string(ref.data(), size_t(ref.size()));
  return stream;
}
 
void StringRefBase::copy_utf8_truncated(char *dst, const int64_t dst_size) const
{
  /* Destination must at least hold the null terminator. */
  BLI_assert(dst_size >= 1);
  /* The current #StringRef is assumed to contain valid UTF8. */
  BLI_assert(BLI_str_utf8_invalid_byte(data_, size_) == -1);
 
  /* Common case when the string can just be copied over entirely. */
  if (size_ < dst_size) {
    this->copy_unsafe(dst);
    return;
  }
 
  const int64_t max_copy_num_without_terminator = std::min(size_, dst_size - 1);
  const size_t new_len = BLI_strncpy_utf8_rlen_unterminated(
      dst, data_, max_copy_num_without_terminator);
  dst[new_len] = '\0';
}
 
void StringRefBase::copy_bytes_truncated(char *dst, const int64_t dst_size) const
{
  /* Destination must at least hold the null terminator. */
  BLI_assert(dst_size >= 1);
 
  /* Common case when the string can just be copied over entirely. */
  if (size_ < dst_size) {
    this->copy_unsafe(dst);
    return;
  }
 
  const int64_t new_len = std::min(size_, dst_size - 1);
  memcpy(dst, data_, new_len);
  dst[new_len] = '\0';
}
 
}  // namespace blender