Section courante

A propos

Section administrative du site

column

 Colonne
Rust

Syntaxe

macro_rules! column {
   () => { ... };
}

Description

Cette macro permet d'obtenir le numéro de colonne dans le fichier source où elle est appelée, sous forme de constante u32.

Remarques

S'étend jusqu'au numéro de colonne d'appel.

Avec line! et file!, ces macros fournissent aux développeurs des informations de débogage sur l'emplacement dans la source.

L'expression étendue est de type u32 et commence à 1 ; la première colonne de chaque ligne est donc évaluée à 1, la seconde à 2,... Ceci est cohérent avec les messages d'erreur des compilateurs ou éditeurs courants. La colonne renvoyée n'est pas nécessairement la ligne de l'appel column! lui-même, mais plutôt la première invocation de la macro précédant l'appel de la macro column!.

Exemples

  1. let current_col = column!();
  2. println!("défini sur la colonne : {current_col}");

column! compte les points de code Unicode, et non les octets ou les graphèmes. Par conséquent, les deux premières invocations renvoient la même valeur, mais pas la troisième.

  1. let a = ("foobar", column!()).1;
  2. let b = ("barre à foo", column!()).1;
  3. let c = ("fõõbãr", column!()).1; // Utilisations combinant le tilde
  4.  
  5. assert_eq!(a, b);
  6. assert_ne!(b, c);

Dernière mise à jour : Mardi, le 5 Août 2025