É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

// Définir une énumération
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

// Énumération améliorée : peut avoir des variables membres, des constructeurs et des méthodes
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

void main() {
  // 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

void main() {
  // 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
心形: &#x2764;
笑脸: &#x1f600;
笑脸码点: [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