Dart core API Reference

`Dart Core`

8 methods

Dart 核心运行时 API,涵盖打印、字符串、列表、映射、异步与类定义。

print(object)

将对象打印到标准输出并换行。

Parameters

Name	Type	Description
object	Object?	任意可打印对象

Returns

void,无返回值,输出到控制台

Example

dart

print('Hello, Dart');
print(3.14);
print([1, 2, 3]);

String (length, substring, toUpperCase)

Dart 字符串类型,提供长度、子串、大小写转换等常用方法。

Returns

String 或 int,取决于调用的方法

Example

dart

String s = 'Hello';
print(s.length);            // 5
print(s.substring(1, 3));   // 'el'
print(s.toUpperCase());     // 'HELLO'

List<T> (add, removeAt, map, where)

可变长度列表,支持增删、映射与过滤。

Returns

List 或元素,取决于方法

Example

dart

var list = <int>[1, 2, 3];
list.add(4);
list.removeAt(0);
var doubled = list.map((e) => e * 2).toList();
var evens = list.where((e) => e.isEven).toList();

Map<K,V> (operator [], putIfAbsent)

键值映射,支持通过键访问与不存在时插入。

Returns

V? 或 V,取决于方法

Example

dart

var m = <String, int>{'a': 1};
print(m['a']);                       // 1
m.putIfAbsent('b', () => 2);
print(m);                            // {a: 1, b: 2}

Future<T> (then, catchError)

异步结果对象,支持链式回调与错误处理。

Returns

Future,链式回调的下一阶段

Example

dart

Future<int> fetch() async => 42;
fetch()
  .then((v) => print('got ${v}'))
  .catchError((e) => print('err: ${e}'));

async / await

异步语法,以同步风格编写异步代码。

Returns

T,await 返回异步结果

Example

dart

Future<String> greet() async {
  await Future.delayed(Duration(seconds: 1));
  return 'hi';
}

void main() async {
  print(await greet());
}

Stream<T> (listen, map)

异步事件流,支持监听与变换。

Returns

StreamSubscription 或 Stream

Example

dart

Stream<int> gen() async* {
  for (var i = 0; i < 3; i++) yield i;
}

gen().listen((v) => print(v));
gen().map((v) => v * 10).listen(print);

class (constructor, named parameters)

类定义,支持构造函数与命名参数。

Returns

类实例

Example

dart

class Point {
  final double x;
  final double y;
  const Point({required this.x, required this.y});

  double distanceTo(Point other) {
    final dx = x - other.x;
    final dy = y - other.y;
    return (dx * dx + dy * dy);
  }
}

var p = Point(x: 1, y: 2);

All references