Горячие клавиши

Нажмите ← или → для перехода между главами

Нажмите S или / для поиска по книге

Нажмите ?, чтобы показать эту справку

Нажмите Esc, чтобы скрыть эту справку

Приложение B: Операторы и символы

Это приложение содержит глоссарий синтаксиса Rust, включая операторы и другие символы, которые встречаются сами по себе или в контексте путей, обобщённых типов, ограничений трейтов, макросов, атрибутов, комментариев, кортежей и скобок.

Операторы

Таблица B-1 содержит операторы в Rust, пример того, как оператор может встретиться в контексте, краткое объяснение и информацию о том, является ли оператор перегружаемым. Если оператор перегружаем, указан соответствующий трейт для перегрузки этого оператора.

Таблица B-1: Операторы

ОператорПримерОбъяснениеПерегружаемый?
!ident!(...), ident!{...}, ident![...]Раскрытие макроса
!!exprПобитовое или логическое дополнениеNot
!=expr != exprСравнение на неравенствоPartialEq
%expr % exprАрифметический остатокRem
%=var %= exprАрифметический остаток с присваиваниемRemAssign
&&expr, &mut exprЗаимствование
&&type, &mut type, &'a type, &'a mut typeТип заимствованного указателя
&expr & exprПобитовое ИBitAnd
&=var &= exprПобитовое И с присваиваниемBitAndAssign
&&expr && exprЛогическое И с коротким замыканием
*expr * exprАрифметическое умножениеMul
*=var *= exprАрифметическое умножение с присваиваниемMulAssign
**exprРазыменованиеDeref
**const type, *mut typeСырой указатель
+trait + trait, 'a + traitСоставное ограничение типа
+expr + exprАрифметическое сложениеAdd
+=var += exprАрифметическое сложение с присваиваниемAddAssign
,expr, exprРазделитель аргументов и элементов
-- exprАрифметическое отрицаниеNeg
-expr - exprАрифметическое вычитаниеSub
-=var -= exprАрифметическое вычитание с присваиваниемSubAssign
->fn(...) -> type, |…| -> typeТип возврата функции и замыкания
.expr.identДоступ к полю
.expr.ident(expr, ...)Вызов метода
.expr.0, expr.1, и так далееИндексация кортежа
...., expr.., ..expr, expr..exprЛитерал диапазона, исключающего правую границуPartialOrd
..=..=expr, expr..=exprЛитерал диапазона, включающего правую границуPartialOrd
....exprСинтаксис обновления литерала структуры
..variant(x, ..), struct_type { x, .. }Привязка шаблона «и остальное»
...expr...expr(Устарело, используйте ..=) В шаблоне: шаблон диапазона, включающего границы
/expr / exprАрифметическое делениеDiv
/=var /= exprАрифметическое деление с присваиваниемDivAssign
:pat: type, ident: typeОграничения
:ident: exprИнициализатор поля структуры
:'a: loop {...}Метка цикла
;expr;Терминатор оператора и элемента
;[...; len]Часть синтаксиса массива фиксированного размера
<<expr << exprСдвиг влевоShl
<<=var <<= exprСдвиг влево с присваиваниемShlAssign
<expr < exprСравнение «меньше»PartialOrd
<=expr <= exprСравнение «меньше или равно»PartialOrd
=var = expr, ident = typeПрисваивание/эквивалентность
==expr == exprСравнение на равенствоPartialEq
=>pat => exprЧасть синтаксиса ветви match
>expr > exprСравнение «больше»PartialOrd
>=expr >= exprСравнение «больше или равно»PartialOrd
>>expr >> exprСдвиг вправоShr
>>=var >>= exprСдвиг вправо с присваиваниемShrAssign
@ident @ patПривязка шаблона
^expr ^ exprПобитовое исключающее ИЛИBitXor
^=var ^= exprПобитовое исключающее ИЛИ с присваиваниемBitXorAssign
|pat | patАльтернативы в шаблоне
|expr | exprПобитовое ИЛИBitOr
|=var |= exprПобитовое ИЛИ с присваиваниемBitOrAssign
||expr || exprЛогическое ИЛИ с коротким замыканием
?expr?Распространение ошибки

Символы, не являющиеся операторами

Следующие таблицы содержат все символы, которые не функционируют как операторы; то есть они не ведут себя как вызов функции или метода.

Таблица B-2 показывает символы, которые встречаются сами по себе и допустимы в различных местах.

Таблица B-2: Отдельный синтаксис

СимволОбъяснение
'identИменованное время жизни или метка цикла
Цифры, за которыми сразу следуют u8, i32, f64, usize и так далееЧисловой литерал конкретного типа
"..."Строковый литерал
r"...", r#"..."#, r##"..."##, и так далееСырой строковый литерал; управляющие символы не обрабатываются
b"..."Байтовый строковый литерал; создаёт массив байтов вместо строки
br"...", br#"..."#, br##"..."##, и так далееСырой байтовый строковый литерал; комбинация сырого и байтового строкового литерала
'...'Символьный литерал
b'...'ASCII-байтовый литерал
|…| exprЗамыкание
!Всегда пустой нижний тип для функций, которые не возвращают управление
_Привязка шаблона «игнорируется»; также используется для удобочитаемости целочисленных литералов

Таблица B-3 показывает символы, которые встречаются в контексте пути через иерархию модулей к элементу.

Таблица B-3: Синтаксис, связанный с путями

СимволОбъяснение
ident::identПуть пространства имён
::pathПуть относительно корня крейта (то есть явный абсолютный путь)
self::pathПуть относительно текущего модуля (то есть явный относительный путь)
super::pathПуть относительно родителя текущего модуля
type::ident, <type as trait>::identАссоциированные константы, функции и типы
<type>::...Ассоциированный элемент для типа, который нельзя напрямую назвать (например, <&T>::..., <[T]>::... и так далее)
trait::method(...)Устранение неоднозначности вызова метода путём указания трейта, который его определяет
type::method(...)Устранение неоднозначности вызова метода путём указания типа, для которого он определён
<type as trait>::method(...)Устранение неоднозначности вызова метода путём указания трейта и типа

Таблица B-4 показывает символы, которые встречаются в контексте использования обобщённых параметров типа.

Таблица B-4: Обобщённые типы

СимволОбъяснение
path<...>Задаёт параметры обобщённого типа в типе (например, Vec<u8>)
path::<...>, method::<...>Задаёт параметры обобщённого типа, функции или метода в выражении; часто называется turbofish (например, "42".parse::<i32>())
fn ident<...> ...Определяет обобщённую функцию
struct ident<...> ...Определяет обобщённую структуру
enum ident<...> ...Определяет обобщённое перечисление
impl<...> ...Определяет обобщённую реализацию
for<...> typeОграничения времени жизни более высокого ранга
type<ident=type>Обобщённый тип, в котором одному или нескольким ассоциированным типам назначены конкретные значения (например, Iterator<Item=T>)

Таблица B-5 показывает символы, которые встречаются в контексте ограничения обобщённых параметров типа ограничениями трейтов.

Таблица B-5: Ограничения трейтов

СимволОбъяснение
T: UОбобщённый параметр T ограничен типами, реализующими U
T: 'aОбобщённый тип T должен пережить время жизни 'a (то есть тип не может транзитивно содержать ссылки со временем жизни короче 'a)
T: 'staticОбобщённый тип T не содержит заимствованных ссылок, кроме ссылок со временем жизни 'static
'b: 'aОбобщённое время жизни 'b должно пережить время жизни 'a
T: ?SizedРазрешает обобщённому параметру типа быть динамически изменяемым по размеру типом
'a + trait, trait + traitСоставное ограничение типа

Таблица B-6 показывает символы, которые встречаются в контексте вызова или определения макросов и указания атрибутов элемента.

Таблица B-6: Макросы и атрибуты

СимволОбъяснение
#[meta]Внешний атрибут
#![meta]Внутренний атрибут
$identПодстановка макроса
$ident:kindМетапеременная макроса
$(...)...Повторение макроса
ident!(...), ident!{...}, ident![...]Вызов макроса

Таблица B-7 показывает символы, которые создают комментарии.

Таблица B-7: Комментарии

СимволОбъяснение
//Строчный комментарий
//!Внутренний строчный документационный комментарий
///Внешний строчный документационный комментарий
/*...*/Блочный комментарий
/*!...*/Внутренний блочный документационный комментарий
/**...*/Внешний блочный документационный комментарий

Таблица B-8 показывает контексты, в которых используются круглые скобки.

Таблица B-8: Круглые скобки

СимволОбъяснение
()Пустой кортеж (он же unit), как литерал, так и тип
(expr)Выражение в скобках
(expr,)Выражение кортежа из одного элемента
(type,)Тип кортежа из одного элемента
(expr, ...)Выражение кортежа
(type, ...)Тип кортежа
expr(expr, ...)Выражение вызова функции; также используется для инициализации кортежных struct и вариантов кортежных enum

Таблица B-9 показывает контексты, в которых используются фигурные скобки.

Таблица B-9: Фигурные скобки

КонтекстОбъяснение
{...}Блочное выражение
Type {...}Литерал структуры

Таблица B-10 показывает контексты, в которых используются квадратные скобки.

Таблица B-10: Квадратные скобки

КонтекстОбъяснение
[...]Литерал массива
[expr; len]Литерал массива, содержащий len копий expr
[type; len]Тип массива, содержащий len экземпляров type
expr[expr]Индексация коллекции; перегружаемо (Index, IndexMut)
expr[..], expr[a..], expr[..b], expr[a..b]Индексация коллекции, имитирующая срез коллекции, с использованием Range, RangeFrom, RangeTo или RangeFull в качестве «индекса»