mirror of
https://github.com/dart-lang/sdk
synced 2024-07-20 09:54:38 +00:00
ac5e3d38c3
Both `sizeOf` and `AllocatorAlloc.call` use the new type as bound. This prevents runtime errors on trying to call these two static methods with unsized native types. All tests testing for these runtime errors have been deleted. The `NativeTypes` implementing `SizedNativeType` are as follows: * The native integer types, `Float`, and `Double`. * `AbiSpecificInteger` and it's subtypes. * `Struct` and `Union` and their subtypes. The The `NativeTypes` not implementing `SizedNativeType` are as follows: * `Void` has no size. * `Opaque` and subtypes have unknown size. * `Handle` is considered opaque. Cannot be used as field in compounds. * `Array` does not carry a size in its type. Can be used as fields in compounds with an annotation specifying the size. * `NativeFunction` is considered opaque. Would have variable size. * `VarArgs` is only a marker in function signatures. `Struct`s and `Union`s can have only `SizedNativeType`s and `Array`s as fields. Documentation for these is in flux in another CL, so we should update it there. This CL also replaces a bunch of `extends NativeType` with `implements` clauses and made `NativeType` itself `abstract`. TEST=Dart SDK build TEST=ffi test suite Bug: https://github.com/dart-lang/sdk/issues/54542 CoreLibraryReviewExempt: VM and dart2wasm feature only. Change-Id: Ib4f6b58f7204bd063ace20133162798d8c9483e8 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/345221 Reviewed-by: Martin Kustermann <kustermann@google.com> Commit-Queue: Daco Harkes <dacoharkes@google.com>
62 lines
1.8 KiB
Dart
62 lines
1.8 KiB
Dart
// Copyright (c) 2021, 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.
|
|
|
|
part of dart.ffi;
|
|
|
|
/// The supertype of all [Abi]-specific integer types.
|
|
///
|
|
/// [Abi]-specific integers should extend this class and annotate it with
|
|
/// [AbiSpecificIntegerMapping] to declare the integer size and signedness
|
|
/// for [Abi.values].
|
|
///
|
|
/// For example:
|
|
///
|
|
/// ```
|
|
/// /// The C `uintptr_t` type.
|
|
/// ///
|
|
/// /// The [UintPtr] type is a native type, and should not be constructed in
|
|
/// /// Dart code.
|
|
/// /// It occurs only in native type signatures and as annotation on [Struct]
|
|
/// /// and [Union] fields.
|
|
/// @AbiSpecificIntegerMapping({
|
|
/// Abi.androidArm: Uint32(),
|
|
/// Abi.androidArm64: Uint64(),
|
|
/// Abi.androidIA32: Uint32(),
|
|
/// Abi.androidX64: Uint64(),
|
|
/// Abi.androidRiscv64: Uint64(),
|
|
/// Abi.fuchsiaArm64: Uint64(),
|
|
/// Abi.fuchsiaX64: Uint64(),
|
|
/// Abi.fuchsiaRiscv64: Uint64(),
|
|
/// Abi.iosArm: Uint32(),
|
|
/// Abi.iosArm64: Uint64(),
|
|
/// Abi.linuxArm: Uint32(),
|
|
/// Abi.linuxArm64: Uint64(),
|
|
/// Abi.linuxIA32: Uint32(),
|
|
/// Abi.linuxX64: Uint64(),
|
|
/// Abi.linuxRiscv32: Uint32(),
|
|
/// Abi.linuxRiscv64: Uint64(),
|
|
/// Abi.macosArm64: Uint64(),
|
|
/// Abi.macosX64: Uint64(),
|
|
/// Abi.windowsIA32: Uint32(),
|
|
/// Abi.windowsX64: Uint64(),
|
|
/// })
|
|
/// final class UintPtr extends AbiSpecificInteger {
|
|
/// const UintPtr();
|
|
/// }
|
|
/// ```
|
|
@Since('2.16')
|
|
base class AbiSpecificInteger implements SizedNativeType {
|
|
const AbiSpecificInteger();
|
|
}
|
|
|
|
/// Mapping for a subtype of [AbiSpecificInteger].
|
|
///
|
|
/// See documentation on [AbiSpecificInteger].
|
|
@Since('2.16')
|
|
final class AbiSpecificIntegerMapping {
|
|
final Map<Abi, NativeType> mapping;
|
|
|
|
const AbiSpecificIntegerMapping(this.mapping);
|
|
}
|