Find a file
Lasse R.H. Nielsen ed3824a220 Tweaks, refactoring and updates on DoubleLinkedQueue.
It's a badly designed class, but this change makes it slightly better.
(We should consider moving it to package:collection and removing it from
the platform libraries. Eventually.)

The changes decouples the public `DoubleLinkedQueueEntry` class from
the actual queue implementation classes, avoiding the latter having
to share a generic `_Link<DoubleLinkedQueueEntry>` interface
which would force them to do otherwise unnecessary casts.

The public class should have been abstract, but isn't.
It's mainly used as the API of the entries exposed by DoubleLinkedQueue,
but it can also be used by itself to build double-linked lists that are
not part of a Queue, and the class can be extended.
If anyone does either, it should keep working, so it needs to be a concrete,
self-contained class with a generative constructor.

That class is moved to dart:_internal to avoid its private
implementation fields from interfering with the queue implementation classes,
which have similar fields, but can now have them at different types.
That's a hack, but it works.

The internal implementation of the DoubleLinkedQueue and its entries
are updated to better follow current programming idioms, and avoids
having fields on classes which don't need them.

Also fixes #27920
(`clear`ing a list now detaches each entry from the list so later `.contains`
won't give the wrong answer).

And moves queue tests from tests/corelib to tests/lib/collection,
since Queue isn't exposed by `dart:core`.

BUG= https://github.com/dart-lang/sdk/issues/27920

Change-Id: Ia3bb340a75886de160cc0e449947e8e7ee587061
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/211265
Commit-Queue: Lasse R.H. Nielsen <lrn@google.com>
Reviewed-by: Nate Bosch <nbosch@google.com>
2021-08-31 12:44:39 +00:00
.dart_tool Drop http_throttle from the SDK 2021-08-24 20:27:34 +00:00
.github "dartfmt" -> "dart format" in issue template. 2021-05-19 00:39:43 +00:00
benchmarks [benchmark] Fix import statement in dart2/EventLoopLatencyRegexp benchmark. 2021-08-24 15:54:14 +00:00
build [gn] Forward the 'pool' parameter through dart actions 2021-07-26 15:20:46 +00:00
client
docs Minor fixes to breaking change process 2021-01-15 21:44:22 +00:00
pkg [cfe] Use explicit language version in incremental test 2021-08-31 10:38:38 +00:00
runtime Tweaks, refactoring and updates on DoubleLinkedQueue. 2021-08-31 12:44:39 +00:00
samples Update to the latest package:ffi 2021-06-18 07:24:51 +00:00
samples-dev/swarm [infra] Migrate scripts to python3 2021-04-15 10:10:20 +00:00
samples_2 Update to the latest package:ffi 2021-06-18 07:24:51 +00:00
sdk Tweaks, refactoring and updates on DoubleLinkedQueue. 2021-08-31 12:44:39 +00:00
tests Tweaks, refactoring and updates on DoubleLinkedQueue. 2021-08-31 12:44:39 +00:00
third_party rev the build of devtools; add a 'dart devtools' command 2021-08-20 16:25:24 +00:00
tools rev the build of devtools; add a 'dart devtools' command 2021-08-20 16:25:24 +00:00
utils Deprecate top level pub. 2021-08-24 08:34:58 +00:00
.clang-format
.gitattributes [web] rename suite dart2js -> web. 2021-02-04 23:11:32 +00:00
.gitconfig
.gitignore [vm] Remove traces of LLVM backend 2021-03-09 20:37:20 +00:00
.gn [infra] Migrate scripts to python3 2021-04-15 10:10:20 +00:00
.mailmap
.packages Drop http_throttle from .packages 2021-08-26 21:16:46 +00:00
.style.yapf
.vpython
AUTHORS [runtime/vm] ARM64: Support unaligned memory accesses for regex. 2019-10-15 20:11:40 +00:00
BUILD.gn [build] Remove runtime_kernel target from GN build 2021-08-13 10:09:41 +00:00
CHANGELOG.md Flow analysis: account for initializers of implicitly typed variables. 2021-08-27 15:01:15 +00:00
codereview.settings [infra] Default presubmits to use python3 2021-08-24 08:20:47 +00:00
CONTRIBUTING.md [doc] Updated dart.dev web repo link 2021-02-22 12:15:22 +00:00
DEPS [co19] Roll co19 to cc4df792d0f02f15bfe04911c1f856b90cb7cbf4 2021-08-31 10:32:59 +00:00
LICENSE Update LICENSE 2021-04-08 07:57:10 +00:00
PATENT_GRANT Rename patent file 2019-08-16 12:03:17 +00:00
PRESUBMIT.py [python3] Migrate PRESUBMIT.py files 2021-08-16 08:29:54 +00:00
README.dart-sdk Add dart2native to sdk README 2020-01-20 09:32:58 +00:00
README.md Update README.md 2021-01-11 23:51:20 +00:00
sdk_args.gni Allow configuring the destination of the SDK in the build output directory 2021-06-29 18:45:29 +00:00
WATCHLISTS Add myself to watch for tools/experimental_features.yaml changes. 2021-03-19 18:09:38 +00:00

Dart

A client-optimized language for fast apps on any platform

Dart is:

  • Optimized for UI: Develop with a programming language specialized around the needs of user interface creation.

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app.

  • Fast on all platforms: Compile to ARM & x64 machine code for mobile, desktop, and backend. Or compile to JavaScript for the web.

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

  • Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.

  • Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit dart.dev to learn more about the language, tools, and to find codelabs.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).

Building Dart

If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.

There are more documents on our wiki.

Contributing to Dart

The easiest way to contribute to Dart is to file issues.

You can also contribute patches, as described in Contributing.