Énumérations et symboles Dart
Une énumération est utilisée pour définir un ensemble de valeurs constantes nommées, ce qui rend le code plus lisible.
Ce chapitre présente comment définir des énumérations Dart, des énumérations améliorées (avec des méthodes et des propriétés), ainsi que les types Symbol et Rune.
Définition d'énumération enum
Une énumération est un type spécial de classe utilisé pour représenter un nombre fixe de valeurs constantes.
Les scénarios les plus typiques consistent à représenter des options finies telles que des états, des directions, des couleurs, etc.
Exemple
enum Status {
pending, // En attente
approved, // Approuvé
rejected, // Rejeté
cancelled, // Annulé
}
void main() {
// Utilisation des valeurs d'énumération
Status currentStatus = Status.pending;
print('Statut actuel : $currentStatus');
// Obtenir l'index via .index (à partir de 0)
print('Valeur de l'index : ${currentStatus.index}'); // 0
// Obtenir toutes les valeurs d'énumération via .values
print(Tous les statuts : ${Status.values});
// Parcourir toutes les valeurs de l'énumération
for (var status in Status.values) {
print(EXEMPLE statut : $status, index : ${status.index});
}
// Obtenir une valeur d'énumération à partir d'une chaîne
Status parsed = Status.values.byName('approved');
print(Statut analysé : $parsed);
// Utilisation des énumérations dans switch
switch (currentStatus) {
case Status.pending:
print(Commande en attente);
break;
case Status.approved:
print(Commande approuvée);
break;
case Status.rejected:
print(Commande rejetée);
break;
case Status.cancelled:
print(Commande annulée);
break;
}
}
当前状态: Status.pending 索引值: 0 所有状态: [Status.pending, Status.approved, Status.rejected, Status.cancelled] EXAMPLE 状态: Status.pending, 索引: 0 EXAMPLE 状态: Status.approved, 索引: 1 EXAMPLE 状态: Status.rejected, 索引: 2 EXAMPLE 状态: Status.cancelled, 索引: 3 解析出的状态: Status.approved 订单待处理
Les énumérations et switch vont parfaitement ensemble. Lorsque vous gérez toutes les valeurs d'énumération dans un switch, le compilateur Dart vérifie si vous avez couvert tous les cas. Cela évite les bugs causés par des branches manquantes.
Énumérations améliorées (avec méthodes et propriétés)
Dart 3.0 a introduit les énumérations améliorées, permettant aux énumérations d'avoir des champs, des méthodes et des constructeurs.
Exemple
enum HttpStatus {
// Les valeurs d'énumération passent des paramètres via le constructeur
ok(200, Requête réussie),
created(201, Ressource créée),
badRequest(400, Requête incorrecte),
unauthorized(401, Non autorisé),
notFound(404, Ressource introuvable),
serverError(500, Erreur interne du serveur);
// Variables membres : chaque valeur d'énumération a un code et un message
final int code;
final String message;
// Constructeur : doit être const
const HttpStatus(this.code, this.message);
// Méthode d'énumération
bool get isSuccess => code >= 200 && code < 300;
bool get isClientError => code >= 400 && code < 500;
bool get isServerError => code >= 500;
// Méthode statique : trouver l'énumération par code de statut
static HttpStatus? fromCode(int code) {
try {
return HttpStatus.values.firstWhere((s) => s.code == code);
} catch (_) {
return null;
}
}
}
void main() {
var status = HttpStatus.notFound;
print(EXEMPLE statut HTTP : $status);
print(Code de statut : ${status.code});
print(Message : ${status.message});
print(Est un succès : ${status.isSuccess});
print('Est une erreur client : ${status.isClientError}');
// Rechercher à l'aide d'une méthode statique
var found = HttpStatus.fromCode(201);
if (found != null) {
print('Statut trouvé : ${found.message}');
}
var unknown = HttpStatus.fromCode(999);
print('Code de statut inconnu : $unknown');
}
EXAMPLE HTTP 状态: HttpStatus.notFound 状态码: 404 Message: 资源未找到 是否成功: false 是否客户端错误: true 找到状态: 资源已创建 未知状态码: null
Les énumérations améliorées font passer les énumérations de « collections de constantes nommées » à « types avec comportement », leur permettant d'encapsuler la logique liée à l'énumération.
Les constructeurs des énumérations améliorées doivent être const, et les variables membres doivent être final. En effet, les valeurs d'énumération sont elles-mêmes des constantes de compilation.
Type Symbol
Symbol représente les identifiants dans les programmes Dart (noms de variables, noms de fonctions, etc.).
Il n'est pas couramment utilisé dans le développement quotidien ; il est principalement utilisé dans des scénarios de réflexion et de génération de code.
Exemple
// Utilisez le préfixe # pour créer un Symbol
Symbol sym1 = #example;
Symbol sym2 = #helloWorld;
print('Symbole 1 : $sym1'); // Symbol("example")
print('Symbole 2 : $sym2'); // Symbol("helloWorld")
// Comparaison de Symbol
Symbol sym3 = #example;
print('sym1 == sym3 : ${sym1 == sym3}'); // vrai
// Un Symbol peut être utilisé comme clé de Map
var metadata = {
#author: 'EXAMPLE',
#version: '1.0.0',
#description: Tutoriel Dart,
};
print('Auteur : ${metadata[#author]}');
}
Symbol 1: Symbol("example")
Symbol 2: Symbol("helloWorld")
sym1 == sym3: true
作者: EXAMPLE
Les symboles sont généralement minifiés après la compilation Dart, donc ne vous fiez pas au résultat de Symbol("example").toString() pour prendre des décisions logiques. L'utilisation correcte de Symbol concerne les opérations de réflexion via la bibliothèque dart:mirrors.
Runes et Unicode
Rune est le type en Dart qui représente les points de code Unicode.
En Dart, les chaînes sont des séquences encodées en UTF-16.
Pour les caractères en dehors du plan multilingue de base (BMP), comme les emoji, Rune est nécessaire pour les gérer.
Exemple
// Obtenir les points de code Unicode de la chaîne
String text = 'EXAMPLE';
print('Caractère : $text');
print('Liste des points de code : ${text.runes.toList()}');
// Parcourir chaque caractère et son point de code
for (var char in text.runes) {
print('${String.fromCharCode(char)} -> U+${char.toRadixString(16).toUpperCase().padLeft(4, '0')}');
}
// Créer un caractère à partir d'un point de code
var heart = String.fromCharCode(0x2764);
print('Heart: $heart');
// Gérer les caractères à plusieurs points de code (comme certains emoji)
var smile = '\u{1F600}'; // Utiliser la syntaxe \u{} pour représenter les caractères au-delà du BMP
print('Smiley: $smile');
// Obtenir les points de code d'un caractère à plusieurs points de code
print('Smiley code points: ${smile.runes.map((r) => 'U+${r.toRadixString(16).toUpperCase()}').toList()}');
}
字符: EXAMPLE 码点列表: [82, 85, 78, 79, 79, 66] R -> U+0052 U -> U+0055 N -> U+004E O -> U+004F O -> U+004F B -> U+0042 心形: ❤ 笑脸: 😀 笑脸码点: [U+1F600]
Dans la plupart des développements quotidiens, vous n'avez pas besoin de travailler directement avec Rune ; les chaînes elles-mêmes gèrent bien Unicode.
Rune est principalement utilisé lorsqu'une manipulation précise des points de code des caractères est nécessaire, comme dans des scénarios de bas niveau tels que les éditeurs de texte et le rendu de police.
autres extensions