Class CAPIString

tiledb/sm/cpp_api/capi_string.h:49–94

* Manages the lifetime of a tiledb_string_t* handle and provides operations on * it. */

 * it.
 */
class CAPIString {
 public:
  /**
   * Constructor. Takes ownership of the handle.
   *
   * @param handle A pointer to the string handle. Must not be null and must not
   * point to a null handle.
   */
  CAPIString(tiledb_string_t** handle) {
    if (handle == nullptr || *handle == nullptr) {
      throw std::invalid_argument(
          "Pointer to string handle cannot be null or point to null handle.");
    }
    string_ = *handle;
    *handle = nullptr;
  }

  ~CAPIString() {
    auto result = tiledb_status(tiledb_string_free(&string_));
    if (result != TILEDB_OK) {
      log_warn("Could not free string; Error code: " + std::to_string(result));
    }
  }

  // Disable copy and move. Because this class owns a resource,
  // copying it must not be supported, but moving it could be.
  CAPIString(const CAPIString&) = delete;
  CAPIString operator=(const CAPIString&) = delete;
  CAPIString(const CAPIString&&) = delete;
  CAPIString operator=(const CAPIString&&) = delete;

  std::string str() const {
    const char* c;
    size_t size;
    auto status = tiledb_status(tiledb_string_view(string_, &c, &size));
    if (status != TILEDB_OK) {
      throw TileDBError(
          "Could not view string; Error code: " + std::to_string(status));
    }
    return {c, size};
  }

 private:
  /** The C API string handle. Invariant: must not be null. */
  tiledb_string_t* string_;
};

/**
 * Returns a C++ string with the handle's data. The handle is subsequently