pkgs/jni/lib/src/lang/jstring.dart

// Copyright (c) 2022, 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 '../jni.dart';
import '../jobject.dart';
import '../jreference.dart';
import '../types.dart';

final class _$JString$Type$ extends JType<JString> {
  const _$JString$Type$();

  @override
  String get signature => 'Ljava/lang/String;';
}

extension type JString._(JObject _$this) implements JObject {
  /// The type which includes information such as the signature of this class.
  static const JType<JString> type = _$JString$Type$();

  /// The number of Unicode characters in this Java string.
  int get length => Jni.env.GetStringLength(reference.pointer);

  /// Construct a [JString] from the contents of Dart string [s].
  JString.fromString(String s)
      : _$this =
            JObject.fromReference(JGlobalReference(Jni.env.toJStringPtr(s)));

  /// Returns the contents as a Dart String.
  ///
  /// If [releaseOriginal] is true, the underlying reference is deleted
  /// after conversion and this object will be marked as released.
  String toDartString({bool releaseOriginal = false}) {
    final result = Jni.env.toDartString(reference.pointer);
    if (releaseOriginal) {
      release();
    }
    return result;
  }
}

extension ToJStringMethod on String {
  /// Returns a [JString] with the contents of this String.
  JString toJString() {
    return JString.fromString(this);
  }
}