Files
sdk/pkg/meta/lib/dart2js.dart
T
pq 2d7235c14d typos
Change-Id: Idbbd0ad4d6097f7c1c5a70de5f3fa4c2d13ff2c7
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/130061
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Phil Quitslund <pquitslund@google.com>
2020-01-02 23:09:17 +00:00

46 lines
1.4 KiB
Dart

// Copyright (c) 2017, 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.
/// Constants for use in metadata annotations to provide hints to dart2js.
///
/// This is an experimental feature and not expected to be useful except for low
/// level framework authors.
///
/// Added at sdk version 2.0.0-dev.6.0
library meta_dart2js;
/// An annotation for methods to request that dart2js does not inline the
/// method.
///
/// import 'package:meta/dart2js.dart' as dart2js;
///
/// @dart2js.noInline
/// String text() => 'A String of unusual size';
const _NoInline noInline = _NoInline();
/// An annotation for methods to request that dart2js always inline the
/// method.
///
/// dart2js will attempt to inline the method regardless of its size. Even with
/// this annotation, there are conditions that can prevent dart2js from inlining
/// a method, including complex control flow.
///
/// import 'package:meta/dart2js.dart' as dart2js;
///
/// @dart2js.tryInline
/// String bigMethod() {
/// for (int i in "Hello".runes) print(i);
/// }
///
/// It is an error to use both `@noInline` and `@tryInline` on the same method.
const _TryInline tryInline = _TryInline();
class _NoInline {
const _NoInline();
}
class _TryInline {
const _TryInline();
}