ffi

Utilities for working with Foreign Function Interface (FFI) code, incl. converting between Dart strings and C strings encoded with UTF-8 and UTF-16.

Please see the API reference for more documentation and the tests for example usage.

For additional details about Dart FFI (dart:ffi), see https://dart.dev/guides/libraries/c-interop.

2.2.0

• Export leaked types.

2.1.5

• Update to the latest lints.
• Add default parameter names for callbacks.

2.1.4

• Require Dart 3.7.0 or greater to opt in to tall style formatting.

2.1.3

• Use package:dart_flutter_team_lints.
• Migrate from DynamicLibrary.process() to @Native external functions. https://github.com/dart-lang/native/issues/1401

2.1.2

• Update repository to point to dart-lang/native.

2.1.1

• Require Dart 3.3.0 or greater.
• Migrate elementAt use to operator +.

2.1.0

• Require Dart 3.0.0 or greater.
• Expose native equivalent to free (nativeFree) from malloc and calloc allocators.

2.0.2

• Fixed a typo in a doc comment.
• Added package topics to the pubspec file.

2.0.1

• Only zero out memory on successful allocation on Windows.
• Upgrade test dev dependency.

2.0.0

• Switch Windows memory allocation to use CoTaskMemAlloc and CoTaskMemFree, which will enable support for NativeFinalizer.
• Require Dart 2.17.0 or greater.

1.2.1

Revert added common C integer types as ABI-specific integers. Instead, these are available in Dart 2.17.

1.2.0 (retracted)

This release requires Dart 2.16.0 or greater.

1.2.0-dev.0

Added common C integer types as ABI-specific integers. These common C integer types will make their way into dart:ffi in 2.17 and be deprecated from this package. Having them in this package enables using them in Dart 2.16.

This pre-release requires Dart 2.16.0-118.0.dev or greater.

1.1.2

Fixed unhandled exception in withZoneArena (#107).

1.1.1

Adds a sanity check to Pointer<Utf8> and Pointer<Utf16> extension methods that receiver is not nullptr.

1.1.0

Adds the arena allocator.

Moves from static analysis with lints in package:pedantic to package:lints.

1.0.0

Bumping the version of this package to 1.0.0.

Removes all deprecated methods, use 0.3.0-nullsafety.3 for migration.

0.3.1-nullsafety.0

Deprecates the static methods on Utf8 and Utf16 and introduces extension methods to replace them.

0.3.0-nullsafety.3

Adds back in deprecated allocate and free to ease migration. These will be removed in the next release.

This pre-release requires Dart 2.12.0-259.9.beta or greater.

0.3.0-nullsafety.1

This pre-release requires Dart 2.12.0-259.8.beta or greater.

Note that this pre-release does not work in Flutter versions containing Dart 2.12.0-260.0.dev - 2.12.0-264.0.dev. Using Allocator.call throws a NoSuchMethodError in these versions. See Flutter Engine #23954 for more info.

0.3.0-nullsafety.0

Changes Utf8 and Utf16 to extend Opaque instead of Struct. This means .ref is no longer available and Pointer<Utf(..)> should be used. See breaking change #44622 for more info.

Removes allocate and free. Instead, introduces calloc which implements the new Allocator interface. See breaking change #44621 for more info.

This pre-release requires Dart 2.12.0-265.0.dev or greater.

0.2.0-nullsafety.1

Adds an optional named length argument to Utf8.fromUtf8().

0.2.0-nullsafety.0

Pre-release (non-stable) release supporting null safety. Requires Dart 2.12.0 or greater.

0.1.3

Stable release incorporating all the previous dev release changes.

Bump SDK constraint to >= 2.6.0.

0.1.3-dev.4

Bump SDK constraint to >= 2.6.0-dev.8.2 which contains the new API of dart:ffi.

0.1.3-dev.3

Replace use of deprecated asExternalTypedData with asTypedList.

0.1.3-dev.2

Incorporate struct API changes, drop type argument of structs.

0.1.3-dev.1

• Adds top-level allocate<T>() and free() methods which can be used as a replacement for the deprecated Pointer.allocate<T>() and Pointer.free() members in dart:ffi.

0.1.1+2

• Expand readme

0.1.1+1

• Fix documentation link

0.1.1

• Add basic Utf16 support

0.1.0

• Initial release supporting Utf8