samples/ffi/sqlite/lib/src/ffi/utf8.dart

// Copyright (c) 2019, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import "dart:convert";
import "dart:ffi";

import "arena.dart";

/// Represents a String in C memory, managed by an [Arena].
class Utf8 extends Struct<Utf8> {
  @Uint8()
  int char;

  /// Allocates a [CString] in the current [Arena] and populates it with
  /// [dartStr].
  static Pointer<Utf8> fromString(String dartStr) =>
      Utf8.fromStringArena(Arena.current(), dartStr);

  /// Allocates a [CString] in [arena] and populates it with [dartStr].
  static Pointer<Utf8> fromStringArena(Arena arena, String dartStr) =>
      arena.scoped(allocate(dartStr));

  /// Allocate a [CString] not managed in and populates it with [dartStr].
  ///
  /// This [CString] is not managed by an [Arena]. Please ensure to [free] the
  /// memory manually!
  static Pointer<Utf8> allocate(String dartStr) {
    List<int> units = Utf8Encoder().convert(dartStr);
    Pointer<Utf8> str = Pointer.allocate(count: units.length + 1);
    for (int i = 0; i < units.length; ++i) {
      str.elementAt(i).load<Utf8>().char = units[i];
    }
    str.elementAt(units.length).load<Utf8>().char = 0;
    return str.cast();
  }

  /// Read the string for C memory into Dart.
  String toString() {
    final str = addressOf;
    if (str == nullptr) return null;
    int len = 0;
    while (str.elementAt(++len).load<Utf8>().char != 0);
    List<int> units = List(len);
    for (int i = 0; i < len; ++i) units[i] = str.elementAt(i).load<Utf8>().char;
    return Utf8Decoder().convert(units);
  }
}