Contents

Language samples

这个集合并不是详尽无遗的,它只是为那些喜欢通过示例学习的人简要介绍的语言. 您可能还需要查看语言和库导览,或者Dart备忘单代码实验室 .

Language tour

全面的Dart语言游览,包括示例. 此页面中的大多数阅读更多链接指向语言导览.

Library tour

Dart核心库的基于示例的介绍. 了解如何使用内置类型,集合,日期和时间,流等.

Hello World

每个应用程序都有一个main()函数. 要在控制台上显示文本,可以使用顶级print()函数:

void main() {
  print('Hello, World!');
}

Variables

即使在类型安全的Dart代码中,由于类型推断,大多数变量也不需要显式类型:

var name = 'Voyager I';
var year = 1977;
var antennaDiameter = 3.7;
var flybyObjects = ['Jupiter', 'Saturn', 'Uranus', 'Neptune'];
var image = {
  'tags': ['saturn'],
  'url': '//path/to/saturn.jpg'
};

阅读有关Dart中变量的更多信息,包括默认值, finalconst关键字以及静态类型.

Control flow statements

Dart支持通常的控制流语句:

if (year >= 2001) {
  print('21st century');
} else if (year >= 1901) {
  print('20th century');
}

for (var object in flybyObjects) {
  print(object);
}

for (int month = 1; month <= 12; month++) {
  print(month);
}

while (year < 2016) {
  year += 1;
}

阅读有关Dart中的控制流语句的更多信息,包括breakcontinueswitchcase以及assert .

Functions

我们建议指定每个函数的参数和返回值的类型:

int fibonacci(int n) {
  if (n == 0 || n == 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}

var result = fibonacci(20);

简写=>arrow )语法对于包含单个语句的函数很方便. 当将匿名函数作为参数传递时,此语法特别有用:

flybyObjects.where((name) => name.contains('turn')).forEach(print);

除了显示匿名函数( where()的参数)之外,此代码还显示您可以将函数用作参数:顶级print()函数是forEach()的参数.

阅读有关Dart中功能的更多信息,包括可选参数,默认参数值和词法范围.

Comments

Dart注释通常以//开头.

// This is a normal, one-line comment.

/// This is a documentation comment, used to document libraries,
/// classes, and their members. Tools like IDEs and dartdoc treat
/// doc comments specially.

/* Comments like these are also supported. */

阅读有关Dart中注释的更多信息,包括文档工具的工作方式.

Imports

要访问其他库中定义的API,请使用import .

// Importing core libraries
import 'dart:math';

// Importing libraries from external packages
import 'package:test/test.dart';

// Importing files
import 'path/to/my_other_file.dart';

阅读有关Dart中库和可见性的更多信息,包括库前缀, showhide以及通过deferred关键字进行的deferred加载.

Classes

这是一个具有三个属性,两个构造函数和一个方法的类的示例. 其中一个属性不能直接设置,因此是使用getter方法(而不是变量)定义的.

class Spacecraft {
  String name;
  DateTime launchDate;

  // Constructor, with syntactic sugar for assignment to members.
  Spacecraft(this.name, this.launchDate) {
    // Initialization code goes here.
  }

  // Named constructor that forwards to the default one.
  Spacecraft.unlaunched(String name) : this(name, null);

  int get launchYear =>
      launchDate?.year; // read-only non-final property

  // Method.
  void describe() {
    print('Spacecraft: $name');
    if (launchDate != null) {
      int years =
          DateTime.now().difference(launchDate).inDays ~/
              365;
      print('Launched: $launchYear ($years years ago)');
    } else {
      print('Unlaunched');
    }
  }
}

您可以这样使用Spacecraft类:

var voyager = Spacecraft('Voyager I', DateTime(1977, 9, 5));
voyager.describe();

var voyager3 = Spacecraft.unlaunched('Voyager III');
voyager3.describe();

阅读有关Dart中的类的更多信息,包括初始化器列表,可选的newconst ,重定向构造函数, factory构造函数,getter,setter等等.

Inheritance

Dart具有单一继承.

class Orbiter extends Spacecraft {
  num altitude;
  Orbiter(String name, DateTime launchDate, this.altitude)
      : super(name, launchDate);
}

阅读有关扩展类,可选的@override注释等的更多信息.

Mixins

Mixins are a way of reusing code in multiple class hierarchies. The following class can act as a mixin:

class Piloted {
  int astronauts = 1;
  void describeCrew() {
    print('Number of astronauts: $astronauts');
  }
}

要将mixin的功能添加到类中,只需使用mixin扩展类即可.

class PilotedCraft extends Spacecraft with Piloted {
  // ···
}

现在, PilotedCraft具有astronauts字段以及describeCrew()方法.

阅读有关mixin的更多信息.

Interfaces and abstract classes

Dart没有interface关键字. 相反,所有类都隐式定义一个接口. 因此,您可以实现任何类.

class MockSpaceship implements Spacecraft {
  // ···
}

阅读有关隐式接口的更多信息.

您可以创建要由具体类扩展(或实现)的抽象类. 抽象类可以包含抽象方法(具有空主体).

abstract class Describable {
  void describe();

  void describeWithEmphasis() {
    print('=========');
    describe();
    print('=========');
  }
}

任何扩展DescribableDescribable具有describeWithEmphasis()方法,该方法调用扩展器的describe() .

阅读有关抽象类和方法的更多信息.

Async

通过使用asyncawait避免回调地狱,并使您的代码更具可读性.

const oneSecond = Duration(seconds: 1);
// ···
Future<void> printWithDelay(String message) async {
  await Future.delayed(oneSecond);
  print(message);
}

上面的方法等效于:

Future<void> printWithDelay(String message) {
  return Future.delayed(oneSecond).then((_) {
    print(message);
  });
}

如下例所示, asyncawait帮助使异步代码易于阅读.

Future<void> createDescriptions(Iterable<String> objects) async {
  for (var object in objects) {
    try {
      var file = File('$object.txt');
      if (await file.exists()) {
        var modified = await file.lastModified();
        print(
            'File for $object already exists. It was modified on $modified.');
        continue;
      }
      await file.create();
      await file.writeAsString('Start describing $object in this file.');
    } on IOException catch (e) {
      print('Cannot create description for $object: $e');
    }
  }
}

您还可以使用async* ,它为您提供了一种很好的,可读的方式来构建流.

Stream<String> report(Spacecraft craft, Iterable<String> objects) async* {
  for (var object in objects) {
    await Future.delayed(oneSecond);
    yield '${craft.name} flies by $object';
  }
}

阅读有关异步支持的更多信息,包括async函数, FutureStream和异步循环( await for ).

Exceptions

要引发异常,请使用throw

if (astronauts == 0) {
  throw StateError('No astronauts.');
}

要捕获异常,请使用带有oncatch (或两者)的try语句:

try {
  for (var object in flybyObjects) {
    var description = await File('$object.txt').readAsString();
    print(description);
  }
} on IOException catch (e) {
  print('Could not describe object: $e');
} finally {
  flybyObjects.clear();
}

注意上面的代码是异步的; try适用于同步代码和async函数中的代码.

阅读有关异常的更多信息,包括堆栈跟踪, rethrow以及Error和Exception之间的区别.

Other topics

更多的代码示例在语言之旅库之旅中 . 另请参阅Dart API参考,其中通常包含示例.

by  ICOPY.SITE