% Атрибуты

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


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

или так:


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

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

#[foo]
struct Foo;

mod bar {
    #![bar]
}

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

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


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

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

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


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

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


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

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