Приложение A: Ключевые слова
Следующие списки содержат ключевые слова, зарезервированные для текущего или будущего использования языком Rust. Таким образом, их нельзя использовать в качестве идентификаторов (кроме случая сырых идентификаторов, который обсуждается в разделе «Сырые идентификаторы»). Идентификаторы — это имена функций, переменных, параметров, полей структур, модулей, крейтов, констант, макросов, статических значений, атрибутов, типов, трейтов или времён жизни.
Ключевые слова, используемые в настоящее время
Ниже приведён список ключевых слов, используемых в настоящее время, с описанием их функциональности.
as: Выполняет примитивное приведение типов, устраняет неоднозначность конкретного трейта, содержащего элемент, или переименовывает элементы в операторахuse.async: ВозвращаетFutureвместо блокировки текущего потока.await: Приостанавливает выполнение до готовности результатаFuture.break: Немедленно выходит из цикла.const: Определяет константные элементы или константные сырые указатели.continue: Переходит к следующей итерации цикла.crate: В пути модуля ссылается на корень крейта.dyn: Динамическая диспетчеризация для трейт-объекта.else: Ветвь по умолчанию для конструкций потока управленияifиif let.enum: Определяет перечисление.extern: Связывает внешнюю функцию или переменную.false: Логический литерал «ложь».fn: Определяет функцию или тип указателя на функцию.for: Перебирает элементы итератора, реализует трейт или задаёт время жизни более высокого ранга.if: Ветвление на основе результата условного выражения.impl: Реализует собственную или трейтовую функциональность.in: Часть синтаксиса циклаfor.let: Связывает переменную.loop: Безусловный цикл.match: Сопоставляет значение с шаблонами.mod: Определяет модуль.move: Заставляет замыкание принимать владение всеми захваченными значениями.mut: Обозначает изменяемость в ссылках, сырых указателях или привязках шаблонов.pub: Обозначает публичную видимость полей структур, блоковimplили модулей.ref: Привязка по ссылке.return: Возврат из функции.Self: Псевдоним типа для типа, который определяется или реализуется.self: Субъект метода или текущий модуль.static: Глобальная переменная или время жизни, длящееся всё время выполнения программы.struct: Определяет структуру.super: Родительский модуль текущего модуля.trait: Определяет трейт.true: Логический литерал «истина».type: Определяет псевдоним типа или ассоциированный тип.union: Определяет объединение; является ключевым словом только при использовании в объявлении объединения.unsafe: Обозначает небезопасный код, функции, трейты или реализации.use: Вводит символы в область видимости.where: Обозначает клаузы, ограничивающие тип.while: Условный цикл на основе результата выражения.
Ключевые слова, зарезервированные для будущего использования
Следующие ключевые слова ещё не имеют никакой функциональности, но зарезервированы языком Rust для потенциального будущего использования:
abstractbecomeboxdofinalgenmacrooverrideprivtrytypeofunsizedvirtualyield
Сырые идентификаторы
Сырые идентификаторы — это синтаксис, позволяющий использовать ключевые слова там, где они
обычно не разрешены. Сырой идентификатор используется путём добавления префикса r# перед ключевым словом.
Например, match — это ключевое слово. Если попытаться скомпилировать следующую функцию,
использующую match в качестве имени:
Имя файла: src/main.rs
fn match(needle: &str, haystack: &str) -> bool {
haystack.contains(needle)
}
будет получена следующая ошибка:
error: expected identifier, found keyword `match`
--> src/main.rs:4:4
|
4 | fn match(needle: &str, haystack: &str) -> bool {
| ^^^^^ expected identifier, found keyword
Ошибка показывает, что ключевое слово match нельзя использовать в качестве идентификатора
функции. Чтобы использовать match в качестве имени функции, нужно применить синтаксис сырого
идентификатора, вот так:
Имя файла: src/main.rs
fn r#match(needle: &str, haystack: &str) -> bool {
haystack.contains(needle)
}
fn main() {
assert!(r#match("foo", "foobar"));
}
Этот код скомпилируется без ошибок. Обратите внимание на префикс r# в имени функции
как в её определении, так и в месте вызова в main.
Сырые идентификаторы позволяют использовать любое выбранное слово в качестве идентификатора, даже если
это слово оказалось зарезервированным ключевым словом. Это даёт больше свободы в выборе
имён идентификаторов, а также позволяет интегрироваться с программами, написанными на
языке, где эти слова не являются ключевыми. Кроме того, сырые идентификаторы позволяют
использовать библиотеки, написанные на другой редакции Rust, отличной от редакции вашего крейта.
Например, try не является ключевым словом в редакции 2015, но является в редакциях 2018, 2021
и 2024. Если вы зависите от библиотеки, написанной с использованием редакции 2015
и имеющей функцию try, вам потребуется использовать синтаксис сырого идентификатора,
в данном случае r#try, чтобы вызвать эту функцию из кода на более поздних редакциях.
См. Приложение E для получения дополнительной информации о редакциях.