コンテンツ

Dart入門

このページでは、Dart言語の主な機能のサンプルを通して、その簡単な紹介をします。

Dart言語について詳しく学ぶには、左側のメニューの言語の下にリストされている個別のトピックページをご覧ください。

Dartのコアライブラリについては、コアライブラリのドキュメントをご覧ください。また、Dartチートシートで、よりインタラクティブな入門を試すこともできます。

Hello World

#

すべてのアプリには、実行が開始されるトップレベルのmain()関数が必要です。明示的に値を返さない関数は、void戻り値型を持ちます。コンソールにテキストを表示するには、トップレベルのprint()関数を使用できます。

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

コマンドライン引数のオプションパラメータを含め、Dartのmain()関数について詳しくはこちらをご覧ください。

変数

#

型安全なDartコードであっても、varを使用して型を明示的に指定せずにほとんどの変数を宣言できます。型推論のおかげで、これらの変数の型は初期値によって決定されます。

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'
};

デフォルト値、finalキーワードとconstキーワード、および静的型など、Dartの変数について詳しくはこちらをご覧ください。

制御フロー文

#

Dartは通常の制御フロー文をサポートしています。

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

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

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

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

breakcontinueswitchcase、およびassertを含む、Dartの制御フロー文について詳しくはこちらをご覧ください。

関数

#

各関数の引数と戻り値の型を指定することをお勧めします

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

var result = fibonacci(20);

単一のステートメントを含む関数には、=>アロー)構文が便利です。この構文は、匿名関数を引数として渡す場合に特に役立ちます。

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

このコードは、匿名関数(where()への引数)を示すだけでなく、関数を引数として使用できることを示しています。トップレベルのprint()関数はforEach()への引数です。

オプションパラメータ、デフォルトパラメータ値、およびレキシカルスコープなど、Dartの関数について詳しくはこちらをご覧ください。

コメント

#

Dartのコメントは通常、//で始まります。

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のコメントについて詳しくはこちらをご覧ください。

インポート

#

他のライブラリで定義されたAPIにアクセスするには、importを使用します。

dart
// 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';

ライブラリプレフィックス、showhide、およびdeferredキーワードによる遅延ロードなど、Dartのライブラリと可視性について詳しくはこちらをご覧ください。

クラス

#

これは、3つのプロパティ、2つのコンストラクター、および1つのメソッドを持つクラスの例です。プロパティの1つは直接設定できないため、(変数の代わりに) getterメソッドを使用して定義されています。メソッドは、文字列リテラル内で変数の文字列同等物を印刷するために文字列補間を使用します。

dart
class Spacecraft {
  String name;
  DateTime? launchDate;

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

  // 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);

  // Method.
  void describe() {
    print('Spacecraft: $name');
    // Type promotion doesn't work on getters.
    var launchDate = this.launchDate;
    if (launchDate != null) {
      int years = DateTime.now().difference(launchDate).inDays ~/ 365;
      print('Launched: $launchYear ($years years ago)');
    } else {
      print('Unlaunched');
    }
  }
}

文字列補間、リテラル、式、およびtoString()メソッドなど、文字列について詳しくはこちらをご覧ください。

Spacecraftクラスは次のように使用できます。

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

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

初期化リスト、オプションのnewconst、コンストラクターのリダイレクト、factoryコンストラクター、getter、setterなど、Dartのクラスについて詳しくはこちらをご覧ください。

列挙型

#

列挙型は、その型の他のインスタンスが存在しないように、定義済みの値またはインスタンスのセットを列挙する方法です。

これは、定義済みの惑星型の簡単なリストを定義する単純なenumの例です。

dart
enum PlanetType { terrestrial, gas, ice }

これは、定数インスタンスの定義済みセット、つまり太陽系の惑星で、惑星を記述するクラスの拡張列挙宣言の例です。

dart
/// Enum that enumerates the different planets in our solar system
/// and some of their properties.
enum Planet {
  mercury(planetType: PlanetType.terrestrial, moons: 0, hasRings: false),
  venus(planetType: PlanetType.terrestrial, moons: 0, hasRings: false),
  // ···
  uranus(planetType: PlanetType.ice, moons: 27, hasRings: true),
  neptune(planetType: PlanetType.ice, moons: 14, hasRings: true);

  /// A constant generating constructor
  const Planet(
      {required this.planetType, required this.moons, required this.hasRings});

  /// All instance variables are final
  final PlanetType planetType;
  final int moons;
  final bool hasRings;

  /// Enhanced enums support getters and other methods
  bool get isGiant =>
      planetType == PlanetType.gas || planetType == PlanetType.ice;
}

Planet列挙型は次のように使用できます。

dart
final yourPlanet = Planet.earth;

if (!yourPlanet.isGiant) {
  print('Your planet is not a "giant planet".');
}

拡張列挙型の要件、自動的に導入されるプロパティ、列挙された値名へのアクセス、switch文のサポートなど、Dartの列挙型について詳しくはこちらをご覧ください。

継承

#

Dartは単一継承です。

dart
class Orbiter extends Spacecraft {
  double altitude;

  Orbiter(super.name, DateTime super.launchDate, this.altitude);
}

クラスの拡張、オプションの@overrideアノテーションなどについて詳しくはこちらをご覧ください。

ミックスイン

#

ミックスインは、複数のクラス階層でコードを再利用する方法です。次はミックスイン宣言です。

dart
mixin Piloted {
  int astronauts = 1;

  void describeCrew() {
    print('Number of astronauts: $astronauts');
  }
}

ミックスインの機能をクラスに追加するには、そのクラスをミックスインで拡張するだけです。

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

PilotedCraftは、astronautsフィールドとdescribeCrew()メソッドを持つようになりました。

ミックスインについて詳しくはこちらをご覧ください。

インターフェースと抽象クラス

#

すべてのクラスは暗黙的にインターフェースを定義します。したがって、任意のクラスを実装できます。

dart
class MockSpaceship implements Spacecraft {
  // ···
}

暗黙のインターフェース、または明示的なinterfaceキーワードについて詳しくはこちらをご覧ください。

具象クラスによって拡張(または実装)される抽象クラスを作成できます。抽象クラスには抽象メソッド(空の本体を持つ)を含めることができます。

dart
abstract class Describable {
  void describe();

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

Describableを拡張するクラスは、describe()のエクステンダの実装を呼び出すdescribeWithEmphasis()メソッドを持ちます。

抽象クラスとメソッドについて詳しくはこちらをご覧ください。

Async

#

コールバック地獄を回避し、asyncawaitを使用してコードをより読みやすくします。

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

上記のメソッドは同等です。

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

次の例が示すように、asyncawaitは、非同期コードを読みやすくするのに役立ちます。

dart
Future<void> createDescriptions(Iterable<String> objects) async {
  for (final 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*も使用できます。これにより、ストリームを構築するための優れた、読みやすい方法が提供されます。

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

async関数、FutureStream、および非同期ループ(await for)を含む、非同期サポートについて詳しくはこちらをご覧ください。

例外

#

例外を発生させるには、throwを使用します。

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

例外をキャッチするには、onまたはcatch(または両方)を含むtry文を使用します。

dart
Future<void> describeFlybyObjects(List<String> flybyObjects) async {
  try {
    for (final 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、およびErrorExceptionの違いを含む例外について詳しくはこちらをご覧ください。

重要な概念

#

Dart言語について学習を続けるにあたって、これらの事実と概念を念頭に置いてください。

  • 変数に格納できるものはすべてオブジェクトであり、すべてのオブジェクトはクラスのインスタンスです。数値、関数、およびnullでさえオブジェクトです。null健全なnull安全を有効にした場合)を除き、すべてのオブジェクトはObjectクラスから継承します。

  • Dartは強く型付けされていますが、Dartは型を推論できるため、型アノテーションはオプションです。var number = 101では、numberint型であると推論されます。

  • null安全を有効にすると、変数はnullになる可能性があると明示的に指定しない限り、nullを含めることができません。型をnullableにするには、型の最後に疑問符(?)を追加します。たとえば、int?型の変数は整数であるか、nullである可能性があります。式がnullにならないとわかっているが、Dartが同意しない場合は、!を追加してnullではないことをアサートできます(そして、nullの場合は例外をスローします)。例:int x = nullableButNotNullInt!

  • 任意の型を許可することを明示的に指定したい場合は、型Object?(null安全を有効にしている場合)、Object、または型チェックをランタイムまで延期する必要がある場合は、特別な型dynamicを使用します。

  • Dartは、List<int>(整数のリスト)やList<Object>(任意の型のオブジェクトのリスト)などのジェネリック型をサポートしています。

  • Dartは、トップレベル関数 (main() など) に加え、クラスやオブジェクトに関連付けられた関数 (それぞれ静的メソッドインスタンスメソッド) をサポートしています。関数の中にさらに関数を作成することもできます (ネストされた関数またはローカル関数)。

  • 同様に、Dartはトップレベルの変数と、クラスやオブジェクトに関連付けられた変数 (静的変数とインスタンス変数) をサポートしています。インスタンス変数は、フィールドまたはプロパティと呼ばれることもあります。

  • Javaとは異なり、Dartにはpublicprotectedprivateのキーワードはありません。識別子がアンダースコア (_) で始まる場合、それはそのライブラリに対してプライベートです。詳細については、ライブラリとインポートを参照してください。

  • 識別子は、文字またはアンダースコア (_) で始まり、その後にこれらの文字と数字の任意の組み合わせが続きます。

  • Dartには、 (実行時の値を持つ) と (値を持たない) の両方があります。例えば、条件式 condition ? expr1 : expr2 は、expr1 または expr2 の値を持ちます。これを値を持たないif-else文と比較してください。文はしばしば1つ以上の式を含みますが、式が直接文を含むことはできません。

  • Dartツールは、警告エラーの2種類の問題を報告できます。警告は、コードが動作しない可能性を示唆するだけで、プログラムの実行を妨げるものではありません。エラーには、コンパイル時エラーと実行時エラーの2種類があります。コンパイル時エラーはコードの実行を完全に妨げ、実行時エラーはコードの実行中に例外が発生します。

追加リソース

#

より詳しいドキュメントやコードサンプルは、コアライブラリのドキュメントDart APIリファレンスにあります。このサイトのコードは、Dartスタイルガイドの規約に従っています。