Dart入門
このページでは、Dart言語の主な機能のサンプルを通して、その簡単な紹介をします。
Dart言語について詳しく学ぶには、左側のメニューの言語の下にリストされている個別のトピックページをご覧ください。
Dartのコアライブラリについては、コアライブラリのドキュメントをご覧ください。また、Dartチートシートで、よりインタラクティブな入門を試すこともできます。
Hello World
#すべてのアプリには、実行が開始されるトップレベルのmain()
関数が必要です。明示的に値を返さない関数は、void
戻り値型を持ちます。コンソールにテキストを表示するには、トップレベルのprint()
関数を使用できます。
void main() {
print('Hello, World!');
}
コマンドライン引数のオプションパラメータを含め、Dartのmain()
関数について詳しくはこちらをご覧ください。
変数
#型安全なDartコードであっても、var
を使用して型を明示的に指定せずにほとんどの変数を宣言できます。型推論のおかげで、これらの変数の型は初期値によって決定されます。
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は通常の制御フロー文をサポートしています。
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;
}
break
とcontinue
、switch
とcase
、およびassert
を含む、Dartの制御フロー文について詳しくはこちらをご覧ください。
関数
#int fibonacci(int n) {
if (n == 0 || n == 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}
var result = fibonacci(20);
単一のステートメントを含む関数には、=>
(アロー)構文が便利です。この構文は、匿名関数を引数として渡す場合に特に役立ちます。
flybyObjects.where((name) => name.contains('turn')).forEach(print);
このコードは、匿名関数(where()
への引数)を示すだけでなく、関数を引数として使用できることを示しています。トップレベルのprint()
関数はforEach()
への引数です。
オプションパラメータ、デフォルトパラメータ値、およびレキシカルスコープなど、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
を使用します。
// 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';
ライブラリプレフィックス、show
とhide
、およびdeferred
キーワードによる遅延ロードなど、Dartのライブラリと可視性について詳しくはこちらをご覧ください。
クラス
#これは、3つのプロパティ、2つのコンストラクター、および1つのメソッドを持つクラスの例です。プロパティの1つは直接設定できないため、(変数の代わりに) getterメソッドを使用して定義されています。メソッドは、文字列リテラル内で変数の文字列同等物を印刷するために文字列補間を使用します。
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
クラスは次のように使用できます。
var voyager = Spacecraft('Voyager I', DateTime(1977, 9, 5));
voyager.describe();
var voyager3 = Spacecraft.unlaunched('Voyager III');
voyager3.describe();
初期化リスト、オプションのnew
とconst
、コンストラクターのリダイレクト、factory
コンストラクター、getter、setterなど、Dartのクラスについて詳しくはこちらをご覧ください。
列挙型
#列挙型は、その型の他のインスタンスが存在しないように、定義済みの値またはインスタンスのセットを列挙する方法です。
これは、定義済みの惑星型の簡単なリストを定義する単純なenum
の例です。
enum PlanetType { terrestrial, gas, ice }
これは、定数インスタンスの定義済みセット、つまり太陽系の惑星で、惑星を記述するクラスの拡張列挙宣言の例です。
/// 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
列挙型は次のように使用できます。
final yourPlanet = Planet.earth;
if (!yourPlanet.isGiant) {
print('Your planet is not a "giant planet".');
}
拡張列挙型の要件、自動的に導入されるプロパティ、列挙された値名へのアクセス、switch文のサポートなど、Dartの列挙型について詳しくはこちらをご覧ください。
継承
#Dartは単一継承です。
class Orbiter extends Spacecraft {
double altitude;
Orbiter(super.name, DateTime super.launchDate, this.altitude);
}
クラスの拡張、オプションの@override
アノテーションなどについて詳しくはこちらをご覧ください。
ミックスイン
#ミックスインは、複数のクラス階層でコードを再利用する方法です。次はミックスイン宣言です。
mixin Piloted {
int astronauts = 1;
void describeCrew() {
print('Number of astronauts: $astronauts');
}
}
ミックスインの機能をクラスに追加するには、そのクラスをミックスインで拡張するだけです。
class PilotedCraft extends Spacecraft with Piloted {
// ···
}
PilotedCraft
は、astronauts
フィールドとdescribeCrew()
メソッドを持つようになりました。
ミックスインについて詳しくはこちらをご覧ください。
インターフェースと抽象クラス
#すべてのクラスは暗黙的にインターフェースを定義します。したがって、任意のクラスを実装できます。
class MockSpaceship implements Spacecraft {
// ···
}
暗黙のインターフェース、または明示的なinterface
キーワードについて詳しくはこちらをご覧ください。
具象クラスによって拡張(または実装)される抽象クラスを作成できます。抽象クラスには抽象メソッド(空の本体を持つ)を含めることができます。
abstract class Describable {
void describe();
void describeWithEmphasis() {
print('=========');
describe();
print('=========');
}
}
Describable
を拡張するクラスは、describe()
のエクステンダの実装を呼び出すdescribeWithEmphasis()
メソッドを持ちます。
抽象クラスとメソッドについて詳しくはこちらをご覧ください。
Async
#コールバック地獄を回避し、async
とawait
を使用してコードをより読みやすくします。
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);
});
}
次の例が示すように、async
とawait
は、非同期コードを読みやすくするのに役立ちます。
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*
も使用できます。これにより、ストリームを構築するための優れた、読みやすい方法が提供されます。
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
関数、Future
、Stream
、および非同期ループ(await for
)を含む、非同期サポートについて詳しくはこちらをご覧ください。
例外
#例外を発生させるには、throw
を使用します。
if (astronauts == 0) {
throw StateError('No astronauts.');
}
例外をキャッチするには、on
またはcatch
(または両方)を含むtry
文を使用します。
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
、およびError
とException
の違いを含む例外について詳しくはこちらをご覧ください。
重要な概念
#Dart言語について学習を続けるにあたって、これらの事実と概念を念頭に置いてください。
変数に格納できるものはすべてオブジェクトであり、すべてのオブジェクトはクラスのインスタンスです。数値、関数、および
null
でさえオブジェクトです。null
(健全なnull安全を有効にした場合)を除き、すべてのオブジェクトはObject
クラスから継承します。Dartは強く型付けされていますが、Dartは型を推論できるため、型アノテーションはオプションです。
var number = 101
では、number
はint
型であると推論されます。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には
public
、protected
、private
のキーワードはありません。識別子がアンダースコア (_
) で始まる場合、それはそのライブラリに対してプライベートです。詳細については、ライブラリとインポートを参照してください。識別子は、文字またはアンダースコア (
_
) で始まり、その後にこれらの文字と数字の任意の組み合わせが続きます。Dartには、式 (実行時の値を持つ) と文 (値を持たない) の両方があります。例えば、条件式
condition ? expr1 : expr2
は、expr1
またはexpr2
の値を持ちます。これを値を持たないif-else文と比較してください。文はしばしば1つ以上の式を含みますが、式が直接文を含むことはできません。Dartツールは、警告とエラーの2種類の問題を報告できます。警告は、コードが動作しない可能性を示唆するだけで、プログラムの実行を妨げるものではありません。エラーには、コンパイル時エラーと実行時エラーの2種類があります。コンパイル時エラーはコードの実行を完全に妨げ、実行時エラーはコードの実行中に例外が発生します。
追加リソース
#より詳しいドキュメントやコードサンプルは、コアライブラリのドキュメントとDart APIリファレンスにあります。このサイトのコードは、Dartスタイルガイドの規約に従っています。
特に断りのない限り、このサイトのドキュメントはDart 3.5.3を反映しています。ページの最終更新日は2024-06-10です。 ソースを表示 または問題を報告。