Public API:

// rust/cxx.h

#include <iosfwd>
#include <string>

namespace rust {

class String final {
  String() noexcept;
  String(const String &) noexcept;
  String(String &&) noexcept;
  ~String() noexcept;

  // Throws std::invalid_argument if not utf-8.
  String(const std::string &);
  String(const char *);
  String(const char *, size_t);

  String &operator=(const String &) noexcept;
  String &operator=(String &&) noexcept;

  explicit operator std::string() const;

  // Note: no null terminator.
  const char *data() const noexcept;
  size_t size() const noexcept;
  size_t length() const noexcept;

  const char *c_str() noexcept;

  using iterator = char *;
  iterator begin() noexcept;
  iterator end() noexcept;

  using const_iterator = const char *;
  const_iterator begin() const noexcept;
  const_iterator end() const noexcept;
  const_iterator cbegin() const noexcept;
  const_iterator cend() const noexcept;

  bool operator==(const String &) const noexcept;
  bool operator!=(const String &) const noexcept;
  bool operator<(const String &) const noexcept;
  bool operator<=(const String &) const noexcept;
  bool operator>(const String &) const noexcept;
  bool operator>=(const String &) const noexcept;

  void swap(String &) noexcept;

std::ostream &operator<<(std::ostream &, const String &);

} // namespace rust


None. Strings may be used as function arguments and function return values, by value or by reference, as well as fields of shared structs.


// src/

mod ffi {
    struct ConcatRequest {
        fst: String,
        snd: String,

    unsafe extern "C++" {
        fn concat(r: ConcatRequest) -> String;

fn main() {
    let concatenated = ffi::concat(ffi::ConcatRequest {
        fst: "fearless".to_owned(),
        snd: "concurrency".to_owned(),
    println!("concatenated: {:?}", concatenated);
// include/concat.h

#pragma once
#include "example/src/"
#include "rust/cxx.h"

rust::String concat(ConcatRequest r);
// src/

#include "example/include/concat.h"

rust::String concat(ConcatRequest r) {
  // The full suite of operator overloads hasn't been added
  // yet on rust::String, but we can get it done like this:
  return std::string(r.fst) + std::string(r.snd);