Вы читаете устаревшую версию TRPL. Новая версия здесь.

% Атрибуты

В Rust объявления могут быть аннотированы с помощью «атрибутов». Они выглядят так:


#![allow(unused)]
fn main() {
#[test]
fn foo() {}
}

или так:


#![allow(unused)]
fn main() {
mod foo {
#![test]
}
}

Разница между ними состоит в символе !, который изменяет его поведение, определяющее к какому элементу применяется атрибут:

#[foo]
struct Foo;

mod bar {
    #![bar]
}

Атрибут #[foo] относится к следующему за ним элементу, который является объявлением struct. Атрибут #![bar] относится к элементу охватывающему его, который является объявлением mod. В остальном они одинаковы. Оба каким-то образом изменяют значение элемента, к которому они прикреплены.

Например, рассмотрим такую функцию:


#![allow(unused)]
fn main() {
#[test]
fn check() {
    assert_eq!(2, 1 + 1);
}
}

Функция помечена как #[test]. Это означает, что она особенная: эта функция будет выполняться при запуске тестов. При компиляции, как правило, она не будет включена. Теперь эта функция является функцией тестирования.

Атрибуты также могут иметь дополнительные данные:


#![allow(unused)]
fn main() {
#[inline(always)]
fn super_fast_fn() {
}
}

Или даже ключи и значения:


#![allow(unused)]
fn main() {
#[cfg(target_os = "macos")]
mod macos_only {
}
}

Атрибуты в Rust используются для ряда различных вещей. Вот ссылка на полный список атрибутов. В настоящее время вы не можете создавать свои собственные атрибуты, компилятор Rust определяет их.