String8.h

Go to the documentation of this file.

///
/// Copyright (C) 2026 Ultralight, Inc. All rights reserved.
/// A license is required for commercial use. https://ultralig.ht
///
#pragma once
#include <Ultralight/Defines.h>
#include <stddef.h>
 
namespace ultralight {
 
class String16;
class String32;
 
///
/// A null-terminated UTF-8 string container.
///
class UExport String8 {
public:
  /// Native character type
  typedef char CharType;
 
  /// Make an empty String8
  String8();
 
  /// Make a String8 from raw, null-terminated UTF-8 string
  String8(const char* c_str);
 
  /// Make a String8 from raw UTF-8 string with certain length
  String8(const char* c_str, size_t len);
 
  /// Make a deep copy of String8
  String8(const String8& other);
 
  /// Move constructor
  String8(String8&& other);
 
  /// Destructor
  ~String8();
 
  /// Assign a String8 to this one, deep copy is made
  String8& operator=(const String8& other);
 
  /// Move assignment operator
  String8& operator=(String8&& other);
 
  /// Append a String8 to this one.
  String8& operator+=(const String8& other);
 
  /// Concatenation operator
  inline friend String8 operator+(String8 lhs, const String8& rhs) { lhs += rhs; return lhs; }
 
  /// Get raw UTF-8 data
  char* data() { return data_; }
 
  /// Get raw UTF-8 data (const)
  const char* data() const { return data_; }
 
  /// Get length in bytes (not including null terminator).
  size_t length() const { return length_; }
 
  /// Get size in bytes (synonym for length())
  size_t size() const { return length_; }
 
  /// Get size in bytes
  size_t sizeBytes() const { return length_ * sizeof(char); }
 
  /// Check if string is empty.
  bool empty() const { return !data_ || length_ == 0; }
 
  /// Get character at specific position
  char& operator[](size_t pos) { return data_[pos]; }
 
  /// Get character at specific position (const)
  const char& operator[](size_t pos) const { return data_[pos]; }
 
  /// Get a UTF-16 copy of this string
  String16 utf16() const;
 
  /// Get a UTF-32 copy of this string
  String32 utf32() const;
 
  /// Hash function
  size_t Hash() const;
 
  /// Comparison operator
  bool operator<(const String8& other) const;
 
  /// Equality operator
  bool operator==(const String8& other) const;
 
  /// Inequality operator
  bool operator!=(const String8& other) const;
 
private:
  char* data_;
  size_t length_;
};
 
}  // namespace ultralight