Note
The contents of this page are informational.
B. Glossary¶
B.1. ABI¶
B.1:1 For ABI, see Application Binary Interface.
B.2. ABI clobber¶
B.2:1
An ABI clobber is an argument to macro core::arch::asm
which
indicates that the values of selected registers might be
overwritten during the execution of an assembly code block.
B.2:2
See AbiClobber
.
B.3. ABI kind¶
B.3:1 The ABI kind indicates the ABI of a construct.
B.3:2
See AbiKind
.
B.4. abort¶
B.4:1 Abort is the immediate termination of a program.
B.5. abstract data type¶
B.5:1 An abstract data type is a collection of other types.
B.6. active attribute¶
B.6:1 An active attribute is an attribute that is removed from the item it decorates.
B.7. addition assignment¶
B.7:1 For addition assignment, see addition assignment expression.
B.8. addition assignment expression¶
B.8:1 An addition assignment expression is a compound assignment expression that uses addition.
B.8:2
See AdditionAssignmentExpression
.
B.9. addition expression¶
B.9:1 An addition expression is an arithmetic expression that uses addition.
B.9:2
See AdditionExpression
.
B.10. adjusted call operand¶
B.10:1 An adjusted call operand is a call operand with possible auto-dereferencing adjustments.
B.11. alignment¶
B.11:1 The alignment of a value specifies which addresses are valid for storing the value.
B.12. all configuration predicate¶
B.12:1 An all configuration predicate is a configuration predicate that models existential quantifier ALL.
B.12:2
See ConfigurationPredicateAll
.
B.13. anonymous loop expression¶
B.13:1 An anonymous loop expression is a loop expression without a label.
B.14. anonymous return type¶
B.14:1 An anonymous return type is an impl trait type ascribed to a function return type.
B.15. anonymous type parameter¶
B.15:1 An anonymous type parameter is an impl trait type ascribed to a function parameter.
B.16. any configuration predicate¶
B.16:1 An any configuration predicate is a configuration predicate that models existential quantifier ANY.
B.16:2
See ConfigurationPredicateAny
.
B.17. Application Binary Interface¶
B.17:1 Application Binary Interface is a set of conventions that dictate how data and computation cross language boundaries.
B.17:2
See AbiSpecification
.
B.18. argument operand¶
B.18:1 An argument operand is an operand which is used as an argument in a call expression or a method call expression.
B.19. arithmetic expression¶
B.19:1 An arithmetic expression is an expression that computes a value from two operands using arithmetic.
B.19:2
See ArithmeticExpression
.
B.20. arithmetic operator¶
B.20:1 An arithmetic operator is the operator of an arithmetic expression.
B.21. arithmetic overflow¶
B.21:1 An arithmetic overflow occurs if an arithmetic expression or a negation expression computes a value of a scalar type that lies outside of the range of valid values for the scalar type.
B.22. arity¶
B.22:1 An arity is the number of tuple fields in a tuple type.
B.23. array¶
B.23:1 An array is a value of an array type.
B.24. array element constructor¶
B.24:1 An array element constructor is an array expression that lists all elements of the array being constructed.
B.24:2
See ArrayElementConstructor
.
B.25. array expression¶
B.25:1 An array expression is an expression that constructs an array.
B.25:2
See ArrayExpression
.
B.26. array repetition constructor¶
B.26:1 An array repetition constructor is an array expression that specifies how many times an element is repeated in the array being constructed.
B.26:2
See ArrayRepetitionConstructor
.
B.27. array type¶
B.27:1 An array type is a sequence type that represents a fixed sequence of elements.
B.27:2
See ArrayTypeSpecification
.
B.28. assembly code block¶
B.28:1 An assembly code block is a sequence of assembly instructions.
B.28:2
See AssemblyCodeBlock
.
B.29. assembly directive¶
B.29:1 An assembly directive is a request to the assembler to perform a particular action or change a setting.
B.30. assembly instruction¶
B.30:1 An assembly instruction is a string literal that represents a low-level assembly operation or an assembly directive.
B.30:2
See AssemblyInstruction
.
B.31. assembly option¶
B.31:1 An assembly option is used to specify a characteristic of or a restriction on the related assembly code block.
B.31:2
See AssemblyOption
.
B.32. assigned operand¶
B.32:1 An assigned operand is the target operand of a compound assignment expression.
B.32:2
See AssignedOperand
.
B.33. assignee expression¶
B.33:1 An assignee expression is an expression that appears as the left operand of an assignment expression.
B.34. assignee operand¶
B.34:1 An assignee operand is the target operand of an assignment expression.
B.34:2
See AssigneeOperand
.
B.35. assignment¶
B.35:1 See assignment expression.
B.36. assignment expression¶
B.36:1 An assignment expression is an expression that assigns the value of a value operand to an assignee operand.
B.36:2
See AssignmentExpression
.
B.37. associated constant¶
B.37:1 An associated constant is a constant that appears as an associated item.
B.38. associated function¶
B.38:1 An associated function is a function that appears as an associated item.
B.39. associated implementation constant¶
B.39:1 An associated implementation constant is an associated constant that appears within an implementation.
B.40. associated implementation function¶
B.40:1 An associated implementation function is an associated function that appears within an implementation.
B.41. associated implementation type¶
B.41:1 An associated implementation type is an associated type that appears within an implementation.
B.42. associated item¶
B.42:1 An associated item is an item that appears within an implementation or a trait.
B.42:2
See AssociatedItem
.
B.43. associated trait constant¶
B.43:1 An associated trait constant is an associated constant that appears within a trait.
B.44. associated trait function¶
B.44:1 An associated trait function is an associated function that appears within a trait.
B.45. associated trait implementation function¶
B.45:1 An associated trait implementation function is an associated function that appears within a trait implementation.
B.46. associated trait implementation item¶
B.46:1 An associated trait implementation item is an associated item that appears within a trait implementation.
B.47. associated trait item¶
B.47:1 An associated trait item is an associated item that appears within a trait.
B.48. associated trait type¶
B.48:1 An associated trait type is an associated type that appears within a trait.
B.49. associated type¶
B.49:1 An associated type is a type alias that appears as an associated item.
B.50. associated type projection¶
B.50:1
An associated type projection is a qualified type path of the form
<type as trait>::associated_type
, where type
is a type, trait
is a qualifying trait, and associated type
is an associated type.
B.51. associativity¶
B.51:1 Associativity is the order by which operands are evaluated within a single expression.
B.52. async block¶
B.52:1 For async block, see async block expression.
B.53. async block expression¶
B.53:1
An async block expression is a block expression that is specified
with keyword async
and encapsulates behavior which is executed in
an asynchronous manner.
B.53:2
See AsyncBlockExpression
.
B.54. async control flow boundary¶
B.54:1 An async control flow boundary is a control flow boundary that additionally allows the suspension of execution via await expressions.
B.55. async function¶
B.55:1
An async function is a function subject to keyword async
.
B.56. atomic¶
B.56:1 See atomic type.
B.57. atomic type¶
B.57:1
An atomic type is a type defined in module
core::sync::atomic
.
B.58. attribute¶
B.58:1 An attribute is a general, free-form metadatum that is interpreted based on its name, convention, language, and tool.
B.59. attribute content¶
B.59:1 An attribute content is a construct that provides the content of an attribute.
B.59:2
See AttributeContent
.
B.60. attribute macro¶
B.60:1 An attribute macro is a procedural macro that consumes two streams of tokens to produce a stream of tokens, and defines a new outer attribute that can be attached to items.
B.61. auto trait¶
B.61:1 An auto trait is a trait that is implicitly and automatically implemented by a type when the types of its constituent fields implement the trait.
B.62. await expression¶
B.62:1 An await expression is an expression that polls a future, suspending the execution of the future until the future is ready.
B.62:2
See AwaitExpression
.
B.63. base initializer¶
B.63:1 A base initializer is a construct that specifies an enum value, a struct value, or a union value to be used as a base for construction in a struct expression.
B.63:2
See BaseInitializer
.
B.64. basic assignment¶
B.64:1 A basic assignment is an assignment expression that is not a destructuring assignment.
B.65. binary crate¶
B.65:1
A binary crate is a crate whose crate type is bin
.
B.66. binary literal¶
B.66:1 A binary literal is an integer literal in base 2.
B.66:2
See BinaryLiteral
.
B.67. binary operator¶
B.67:1 A binary operator is an operator that operates on two operands.
B.68. binding¶
B.68:1 A binding of a binding pattern binds a matched value to a name.
B.68:2
See Binding
.
B.69. binding argument¶
B.69:1 A binding argument is a generic argument that supplies the type of an associated trait type.
B.70. binding bound argument¶
B.70:1 A binding bound argument is a generic argument that further imposes bounds on an associated trait type.
B.71. binding mode¶
B.71:1 Binding mode is the mechanism by which a matched value is bound to a binding of a pattern.
B.72. binding pattern¶
B.72:1 A binding pattern is either an identifier pattern or a shorthand deconstructor.
B.73. binding scope¶
B.74. bit and assignment¶
B.74:1 For bit and assignment, see bit and assignment expression.
B.75. bit and assignment expression¶
B.75:1 A bit and assignment expression is a compound assignment expression that uses bit and arithmetic.
B.75:2
See BitAndAssignmentExpression
.
B.76. bit and expression¶
B.76:1 A bit and expression is a bit expression that uses bit and arithmetic.
B.76:2
See BitAndExpression
.
B.77. bit expression¶
B.77:1 A bit expression is an expression that computes a value from two operands using bit arithmetic.
B.77:2
See BitExpression
.
B.78. bit or assignment¶
B.78:1 For bit or assignment, see bit or assignment expression.
B.79. bit or assignment expression¶
B.79:1 A bit or assignment expression is a compound assignment expression that uses bit or arithmetic.
B.79:2
See BitOrAssignmentExpression
.
B.80. bit or expression¶
B.80:1 A bit or expression is a bit expression that uses bit or arithmetic.
B.80:2
See BitOrExpression
.
B.81. bit xor assignment¶
B.81:1 For bit xor assignment, see bit xor assignment expression.
B.82. bit xor assignment expression¶
B.82:1 A bit xor assignment expression is a compound assignment expression that uses bit exclusive or arithmetic.
B.82:2
See BitXorAssignmentExpression
.
B.83. bit xor expression¶
B.83:1 A bit xor expression is a bit expression that uses bit exclusive or arithmetic.
B.83:2
See BitXorExpression
.
B.84. block comment¶
B.84:1 A block comment is a comment that spans one or more lines.
B.84:2
See BlockComment
.
B.85. block expression¶
B.85:1 A block expression is an expression that sequences expressions and statements.
B.85:2
See BlockExpression
.
B.86. bool¶
B.86:1
bool
is a type whose values denote the truth values of logic
and Boolean algebra.
B.87. boolean literal¶
B.87:1 A boolean literal is a literal that denotes the truth values of logic and Boolean algebra.
B.87:2
See BooleanLiteral
.
B.88. borrow¶
B.89. borrow expression¶
B.89:1 A borrow expression is an expression that borrows the value of its operand and creates a reference to the memory location of its operand.
B.89:2
See BorrowExpression
.
B.90. borrowed¶
B.90:1 A memory location is borrowed when a reference pointing to it is active.
B.91. borrowing¶
B.91:1 Borrowing is the process of temporarily associating a reference with a value without transferring ownership permanently.
B.92. bound¶
B.92:1 A bound imposes a constraint on a generic parameter by limiting the set of possible generic substitutions.
B.92:2
See TypeBound
.
B.93. bound pattern¶
B.93:1 A bound pattern is a pattern that imposes a constraint on a related identifier pattern.
B.93:2
See BoundPattern
.
B.94. break expression¶
B.94:1 A break expression is an expression that terminates a loop expression or a named block expression.
B.94:2
See BreakExpression
.
B.95. break type¶
B.95:1 Break type is the type of the operand of a break expression.
B.96. break value¶
B.96:1 Break value is the value of the operand of a break expression.
B.97. built-in attribute¶
B.97:1 A built-in attribute is a language-defined attribute.
B.97:2
See InnerBuiltinAttribute
, OuterBuiltinAttribute
.
B.98. built-in trait¶
B.98:1 A built-in trait is a language-defined trait.
B.99. byte literal¶
B.99:1 A byte literal is a literal that denotes a fixed byte value.
B.99:2
See ByteLiteral
.
B.100. byte string literal¶
B.100:1
A byte string literal is a literal that consists of multiple
AsciiCharacters
.
B.100:2
See ByteStringLiteral
.
B.101. C¶
B.101:1 C is the programming language described in the ISO/IEC 9899:2018 International Standard.
B.102. C representation¶
B.102:1 C representation is a type representation that lays out types such that they are interoperable with the C language.
B.103. C signed int type¶
B.103:1 C signed int type is the signed int type of the C language.
B.104. c string literal¶
B.104:1 A c string literal is a literal that consists of multiple characters with an implicit 0x00 byte appended to it.
B.104:2
See CStringLiteral
.
B.105. Call conformance¶
B.105:1 Call conformance measures the compatibility between a set of argument operands and a set if function parameters or fields.
B.106. call expression¶
B.106:1 A call expression is an expression that invokes a function or constructs a tuple struct value or tuple enum variant value.
B.106:2
See CallExpression
.
B.107. call operand¶
B.107:1 A call operand is the function being invoked or the tuple struct value or tuple enum variant value being constructed by a call expression.
B.107:2
See CallOperand
.
B.108. call resolution¶
B.108:1 Call resolution is a kind of resolution that applies to a call expression.
B.109. call site hygiene¶
B.109:1
Call site hygiene is a type of hygiene which resolves to the
MacroInvocation
site. Identifiers with call site hygiene can
reference the environment of the MacroRulesDeclaration
, can reference the
environment of the MacroInvocation
, and are considered unhygienic.
B.110. callee type¶
B.110:1
A callee type is either a function item type, a
function pointer type, a tuple struct type, a tuple enum variant
or a type that implements any of the core::ops::Fn
,
core::ops::FnMut
, or core::ops::FnOnce
traits.
B.111. capture mode¶
B.111:1 Capture mode is the mechanism by which a capture target is captured.
B.112. capture target¶
B.112:1 A capture target is either a binding or a field of a binding.
B.113. capturing¶
B.113:1 Capturing is the process of saving the capture targets of a capturing expression's capturing environment.
B.114. capturing environment¶
B.114:1 The capturing environment of a capturing expression consists of all capture targets that are defined outside the capturing expression.
B.115. capturing expression¶
B.115:1 A capturing expression is either an async block expression or a closure expression.
B.116. cast¶
B.116:1 Cast or casting is the process of changing the type of an expression.
B.117. char¶
B.117:1
char
is a type whose values denote Unicode characters.
B.118. character literal¶
B.118:1 A character literal is a literal that denotes a fixed Unicode character.
B.118:2
See CharacterLiteral
.
B.119. closure body¶
B.119:1 A closure body is a construct that represents the executable portion of a closure expression.
B.119:2
See ClosureBody
, ClosureBodyWithReturnType
.
B.120. closure expression¶
B.120:1 A closure expression is an expression that defines a closure type and constructs a value of that type.
B.120:2
See ClosureExpression
.
B.121. closure parameter¶
B.121:1 A closure parameter is a construct that yields a set of bindings that bind matched input values to names at the site of a call expression or a method call expression.
B.121:2
See ClosureParameter
.
B.122. closure type¶
B.122:1 A closure type is a unique anonymous function type that encapsulates all capture targets of a closure expression.
B.123. code point¶
B.123:1 In Unicode, a code point is a numeric value that maps to a character.
B.124. comment¶
B.124:1 A comment is a lexical element that acts as an annotation or an explanation in program text.
B.124:2
See Comment
.
B.125. comparison expression¶
B.125:1 A comparison expression is an expression that compares the values of two operands.
B.125:2
See ComparisonExpression
.
B.126. compilation root¶
B.126:1 A compilation root is an input to a compilation performed by a tool.
B.127. compound assignment¶
B.127:1 For compound assignment, see compound assignment expression.
B.128. compound assignment expression¶
B.128:1 A compound assignment expression is an expression that first computes a value from two operands and then assigns the value to an assigned operand.
B.128:2
See CompoundAssignmentExpression
.
B.129. concrete type¶
B.129:1 A concrete type is a type described by a type specification.
B.130. conditional compilation¶
B.130:1 Conditional compilation is the process of compiling conditionally-compiled source code.
B.131. conditionally-compiled source code¶
B.131:1 Conditionally-compiled source code is source code that may or may not be considered a part of a Rust program depending on certain conditions.
B.132. configuration predicate¶
B.132:1
A configuration predicate is a construct that evaluates statically
to either true
or false
, and controls conditional compilation.
B.132:2
See ConfigurationPredicate
.
B.133. const block expression¶
B.133:1
A const block expression is a block expression that is specified
with keyword const
and encapsulates behavior which is evaluated
statically.
B.134. constant¶
B.134:1 A constant is an immutable value whose uses are substituted by the value.
B.134:2
See ConstantDeclaration
.
B.135. constant argument¶
B.135:1 A constant argument is a generic argument that supplies the value of a constant parameter.
B.135:2
See ConstantArgument
.
B.136. constant context¶
B.136:1 A constant context is a construct that requires a constant expression.
B.137. constant expression¶
B.137:1 A constant expression is an expression that can be evaluated statically.
B.138. constant function¶
B.138:1
A constant function is a function subject to keyword const
.
B.139. constant initializer¶
B.139:1 A constant initializer is a construct that provides the value of its related constant.
B.139:2
See ConstantInitializer
.
B.140. constant parameter¶
B.140:1 A constant parameter is a generic parameter for a constant.
B.140:2
See ConstantParameter
.
B.141. constant parameter initializer¶
B.141:1 A constant parameter initializer is a construct that provides the default :t:`value of its related constant parameter.
B.141:2
See ConstantParameterInitializer
.
B.142. constant promotion¶
B.142:1 Constant promotion is the process of converting a value expression into a constant.
B.143. constrain¶
B.143:1 A generic parameter is said to constrain an implementation if it makes the implementation's applicability more narrow.
B.144. construct¶
B.144:1 A construct is a piece of program text that is an instance of a syntactic category.
B.145. constructee¶
B.145:1 A constructee indicates the enum variant, struct or union whose value is being constructed by a struct expression.
B.146. container operand¶
B.146:1 A container operand is an operand that indicates the value whose field is selected in a field access expression.
B.146:2
See ContainerOperand
.
B.147. continue expression¶
B.147:1 A continue expression is an expression that first terminates and then restarts a loop expression.
B.147:2
See ContinueExpression
.
B.148. control flow boundary¶
B.148:1 A control flow boundary is a construct that limits control flow from returning beyond the construct, and acts as the target of control flow returning operations.
B.149. copy type¶
B.149:1
A copy type is a type that implements the
core::marker::Copy
trait.
B.150. crate¶
B.150:1 A crate is a unit of compilation and linking that contains a tree of nested modules.
B.151. crate import¶
B.151:1 A crate import specifies a dependency on an external crate.
B.151:2
See ExternalCrateImport
.
B.152. crate indication¶
B.152:1 A crate indication is a construct that indicates a crate.
B.152:2
See CrateIndication
.
B.153. crate public modifier¶
B.153:1 A crate public modifier is a visibility modifier that grants a name public visibility within the current crate only.
B.153:2
See CratePublicModifier
.
B.154. crate root¶
B.154:1 A crate root is an entry point into a crate.
B.155. crate root module¶
B.155:1 A crate root module is the root of the nested module tree of a crate.
B.156. crate type¶
B.156:1
The crate type of a crate is the value of the attribute
crate_type
of a crate or the value of --crate-type
flag passed to
the tool compiling the crate.
B.157. dangling¶
B.157:1
A value of an indirection type is dangling if it is either
null
or not all of the bytes at the referred memory location are part of
the same allocation.
B.158. data race¶
B.158:1 A data race is a scenario where two or more threads access a shared memory location concurrently.
B.159. decimal literal¶
B.159:1 A decimal literal is an integer literal in base 10.
B.159:2
See DecimalLiteral
.
B.160. declaration¶
B.160:1 A declaration is a construct that introduces a name for an entity.
B.161. declarative macro¶
B.161:1 A declarative macro is a macro that associates a name with a set of syntactic transformation rules.
B.161:2
See MacroRulesDeclaration
.
B.162. deconstructee¶
B.162:1 A deconstructee indicates the enum variant or type that is being deconstructed by a struct pattern.
B.162:2
See Deconstructee
.
B.163. default representation¶
B.163:1 Default representation is a type representation that does not make any guarantees about layout.
B.164. definition site hygiene¶
B.164:1
Definition site hygiene is a type of hygiene which resolves to the
MacroRulesDeclaration
site. Identifiers with
definition site hygiene cannot reference the environment of the
MacroRulesDeclaration
, cannot be referenced by the environment of a
MacroInvocation
, and are considered hygienic.
B.165. dereference¶
B.165:1 A dereference is the memory location produced by evaluating a dereference expression.
B.166. dereference expression¶
B.166:1 A dereference expression is an expression that obtains the pointed-to memory location of its operand.
B.166:2
See DereferenceExpression
.
B.167. dereference type¶
B.167:1
A dereference type is either a reference type or a type that
implements the core::ops::Deref
trait.
B.168. dereference type chain¶
B.168:1 A dereference type chain is a sequence of dereference types.
B.169. derive macro¶
B.169:1
A derive macro is a procedural macro that consumes a stream of
tokens and produces a stream of tokens, and is invoked via attribute
derive
.
B.170. destruction¶
B.170:1 Destruction is the process of recovering resources associated with a value as it goes out of scope.
B.171. destructor¶
B.171:1 A destructor is a function that is invoked immediately before the destruction of a value of a drop type.
B.172. destructuring assignment¶
B.172:1 A destructuring assignment is an assignment expression where the assignee operand is either an array expression, a struct expression, or a tuple expression.
B.173. direction modifier¶
B.173:1 A direction modifier is a construct that indicates whether a register argument initializes a register, assigns the value of a register to an expression, or both.
B.173:2
See DirectionModifier
.
B.174. discriminant¶
B.174:1 A discriminant is an opaque integer that identifies an enum variant.
B.175. discriminant initializer¶
B.175:1 A discriminant initializer provides the value of a discriminant.
B.175:2
See DiscriminantInitializer
.
B.176. discriminant type¶
B.176:1 A discriminant type is the type of a discriminant.
B.177. diverging expression¶
B.177:1 A diverging expression is an expression whose evaluation causes program flow to diverge from the normal evaluation order.
B.178. diverging type variable¶
B.178:1 A diverging type variable is a type variable that can refer to any type and originates from a diverging expression.
B.179. division assignment¶
B.179:1 For division assignment, see division assignment expression.
B.180. division assignment expression¶
B.180:1 A division assignment expression is a compound assignment expression that uses division.
B.180:2
See DivisionAssignmentExpression
.
B.181. division expression¶
B.181:1 A division expression is an arithmetic expression that uses division.
B.181:2
See DivisionExpression
.
B.182. doc comment¶
B.182:1 A doc comment is a comment class that includes inner block docs, inner line docs, outer block docs, and outer line docs.
B.183. drop construct¶
B.183:1 A drop construct is a construct that employs a drop scope.
B.184. drop order¶
B.184:1 Drop order is the order by which values are dropped when a drop scope is left.
B.185. drop scope¶
B.185:1 A drop scope is a region of program text that governs the dropping of values.
B.186. drop scope extension¶
B.186:1 Drop scope extension is the process of extending a drop scope associated with a temporary to prevent the premature dropping of the temporary.
B.187. drop type¶
B.187:1
A drop type is a type that implements the core::ops::Drop
trait or contains a field that has a destructor.
B.188. dropping¶
B.188:1 Dropping a value is the act of invoking the destructor of the related type.
B.189. dynamically sized type¶
B.189:1
A dynamically sized type is a type that does not implement the
core::marker::Sized
trait.
B.190. elaboration¶
B.190:1 Elaboration is the process by which a declaration achieves its runtime effects.
B.191. element type¶
B.191:1 An element type is the type of the elements of an array type or a slice type.
B.191:2
See ElementType
.
B.192. elided¶
B.192:1 For elided, see elided lifetime.
B.193. elided lifetime¶
B.193:1 An elided lifetime is either an unnamed lifetime or a lifetime that has been explicitly omitted from a function signature or an implementation.
B.194. else expression¶
B.194:1 An else expression is an expression that represents either a block expression, an if expression, or an if let expression.
B.194:2
See ElseExpression
.
B.195. empty statement¶
B.195:1 An empty statement is a statement expressed as character 0x3B (semicolon).
B.196. entity¶
B.196:1 An entity is a construct that can be referred to within program text, usually via a field access expression or a path.
B.197. enum¶
B.198. enum field¶
B.198:1 An enum field is a field of an enum variant.
B.199. enum type¶
B.199:1 An enum type is an abstract data type that contains enum variants.
B.199:2
See EnumDeclaration
.
B.200. enum value¶
B.201. enum variant¶
B.201:1 An enum variant is a construct that declares one of the possible variations of an enum.
B.201:2
See EnumVariant
.
B.202. enum variant value¶
B.202:1 An enum variant value is the enum value of the corresponding enum of the enum variant.
B.203. equals expression¶
B.203:1 An equals expression is a comparison expression that tests equality.
B.203:2
See EqualsExpression
.
B.204. error propagation expression¶
B.204:1 An error propagation expression is an expression that either evaluates to a value of its operand or returns a value to the next control flow boundary.
B.204:2
See ErrorPropagationExpression
.
B.205. escaped character¶
B.205:1
An escaped character is the textual representation for a character with
special meaning. An escaped character consists of character 0x5C (reverse
solidus), followed by the single character encoding of the special meaning
character. For example, \t
is the escaped character for 0x09 (horizontal
tabulation).
B.206. evaluated¶
B.206:1 See evaluation.
B.207. evaluation¶
B.207:1 Evaluation is the process by which an expression achieves its runtime effects.
B.208. exclusive range pattern¶
B.208:1 An exclusive range pattern is a range pattern with both a range pattern low bound and a range pattern high bound.
B.208:2
See ExclusiveRangePattern
.
B.209. executed¶
B.209:1 See execution.
B.210. execution¶
B.210:1 Execution is the process by which a statement achieves its runtime effects.
B.211. explicit register argument¶
B.211:1 An explicit register argument is a register argument that uses an explicit register name.
B.212. explicit register name¶
B.212:1 An explicit register name is a target-specific string that identifies a register.
B.212:2
See ExplicitRegisterName
.
B.213. explicitly declared entity¶
B.213:1 An explicitly declared entity is an entity that has a declaration.
B.214. exported function¶
B.214:1 An exported function is an export of a function.
B.215. exported static¶
B.215:1 An exported static is an export of a static.
B.216. expression¶
B.216:1 An expression is a construct that produces a value, and may have side effects at run-time.
B.216:2
See Expression
.
B.217. expression statement¶
B.217:1 An expression statement is an expression whose result is ignored.
B.217:2
See ExpressionStatement
.
B.218. expression-with-block¶
B.218:1 An expression-with-block is an expression whose structure involves a block expression.
B.218:2
See ExpressionWithBlock
.
B.219. expression-without-block¶
B.219:1 An expression-without-block is an expression whose structure does not involve a block expression.
B.219:2
See ExpressionWithoutBlock
.
B.220. external block¶
B.220:1 An external block is a construct that provides the declarations of foreign functions as unchecked imports.
B.220:2
See ExternalBlock
.
B.221. external function¶
B.221:1 An external function is an unchecked import of a foreign function.
B.222. external function item type¶
B.222:1 An external function item type is a function item type where the related function is an external function.
B.223. external static¶
B.223:1 An external static is an import of a foreign variable.
B.224. f32¶
B.224:1
f32
is a floating-point type equivalent to the IEEE 754-2008
binary32 type.
B.225. f64¶
B.225:1
f64
is a floating-point type equivalent to the IEEE 754-2008
binary64 type.
B.226. fat pointer¶
B.226:1 A fat pointer is a value of a fat pointer type.
B.227. fat pointer type¶
B.227:1 A fat pointer type is an indirection type whose contained type specification is a dynamically sized type.
B.228. FFI¶
B.228:1 For FFI, see Foreign Function Interface.
B.229. field¶
B.229:1 A field is an element of an abstract data type.
B.230. field access expression¶
B.230:1 A field access expression is an expression that accesses a field of a value.
B.230:2
See FieldAccessExpression
.
B.231. field index¶
B.231:1 A field index is the position of a field within a tuple struct type or tuple enum variant. The first field has a field index of zero, the Nth field has a field index of N-1.
B.231:2
See FieldIndex
.
B.232. field list¶
B.232:1
A field list is a RecordStructFieldList
or TupleStructFieldList
.
B.233. field resolution¶
B.233:1 Field resolution is a form of resolution that applies to a field access expression.
B.234. field selector¶
B.234:1 A field selector is a construct that selects the field to be accessed in a field access expression.
B.234:2
See FieldSelector
.
B.235. final match arm¶
B.235:1 A final match arm is the last match arm of a match expression.
B.235:2
See FinalMatchArm
.
B.236. fixed sized type¶
B.236:1
A fixed sized type is a type that implements the
core::marker::Sized
trait.
B.237. float literal¶
B.237:1 A float literal is a numeric literal that denotes a fractional number.
B.237:2
See FloatLiteral
.
B.238. float suffix¶
B.238:1 A float suffix is a component of a float literal that specifies an explicit floating-point type.
B.238:2
See FloatSuffix
.
B.239. floating-point type¶
B.239:1 A floating-point type is a numeric type whose values denote fractional numbers.
B.240. floating-point type variable¶
B.240:1 A floating-point type variable is a type variable that can refer only to floating-point types.
B.241. floating-point value¶
B.241:1 A floating-point value is a value of a floating-point type.
B.242. for loop¶
B.242:1 For for loop, see for loop expression.
B.243. for loop expression¶
B.243:1 A for loop expression is a loop expression that continues to evaluate its loop body as long as its subject expression yields a value.
B.243:2
See ForLoopExpression
.
B.244. Foreign Function Interface¶
B.244:1 Foreign Function Interface employs ABI, attributes, external block, external functions, linkage, and type layout to interface a Rust program with foreign code.
B.245. fragment specifier¶
B.245:1 A fragment specifier is a construct that indicates the type of a metavariable.
B.245:2
See MacroFragmentSpecifier
.
B.246. full range expression¶
B.246:1 A full range expression is a range expression that covers the full range of a type.
B.247. function¶
B.247:1 A function is a value of a function type that models a behavior.
B.247:2
See FunctionDeclaration
.
B.248. function body¶
B.248:1 A function body is the block expression of a function.
B.248:2
See FunctionBody
.
B.249. function item type¶
B.249:1 A function item type is a unique anonymous function type that identifies a function.
B.250. function lifetime elision¶
B.250:1
Function lifetime elision is a form of lifetime elision that applies
to functions, function pointer type parameters and paths
resolving to one of the core::ops::Fn
, core::ops::FnMut
, and
core::ops::FnOnce
traits.
B.251. function parameter¶
B.251:1 A function parameter is a construct that yields a set of bindings that bind matched input values to names at the site of a call expression or a method call expression.
B.251:2
See FunctionParameter
.
B.252. function pointer type¶
B.252:1 A function pointer type is an indirection type that refers to a function.
B.252:2
See FunctionPointerTypeSpecification
.
B.253. function pointer type parameter¶
B.253:1 A function pointer type parameter is a function parameter of a function pointer type.
B.253:2
See FunctionPointerTypeParameter
.
B.254. function qualifier¶
B.254:1 A function qualifier is a construct that determines the role of a function.
B.254:2
See FunctionQualifierList
.
B.255. function signature¶
B.255:1 A function signature is a unique identification of a function that encompasses of its function qualifiers, name, generic parameters, function parameters, return type, and where clause.
B.256. function type¶
B.256:1 A function type is either a closure type or a function item type.
B.257. function-like macro¶
B.257:1 A function-like macro is a procedural macro that consumes a stream of tokens and produces a stream of tokens, and is invoked directly.
B.258. fundamental¶
B.258:1 A trait or type is fundamental when its implementation coherence rules are relaxed and the trait or type is always treated as if it was a local trait or a local type.
B.259. future¶
B.259:1
A future represents a value of a type that implements the
core::future::Future
trait which may not have finished computing
yet.
B.260. future operand¶
B.260:1 A future operand is an operand whose future is being awaited by an await expression.
B.260:2
See FutureOperand
.
B.261. generic argument¶
B.261:1 A generic argument supplies a static input for an associated trait type or a generic parameter.
B.261:2
See GenericArgumentList
.
B.262. generic associated type¶
B.262:1 A generic associated type is an associated type with generic parameters.
B.263. generic conformance¶
B.263:1 Generic conformance measures the compatibility between a set of generic parameters and a set of generic arguments.
B.264. generic enum¶
B.264:1 A generic enum is an enum with generic parameters.
B.265. generic function¶
B.265:1 A generic function is a function with generic parameters.
B.266. generic implementation¶
B.266:1 A generic implementation is an implementation with generic parameters.
B.267. generic parameter¶
B.267:1 A generic parameter is a placeholder for a constant, a lifetime, or a type whose value is supplied statically by a generic argument.
B.267:2
See GenericParameterList
.
B.268. generic parameter scope¶
B.268:1 A generic parameter scope is a scope for generic parameters.
B.269. generic struct¶
B.269:1 A generic struct is a struct with generic parameters.
B.270. generic substitution¶
B.270:1 A generic substitution is the replacement of a generic parameter with a generic argument.
B.271. generic trait¶
B.271:1 A generic trait is a trait with generic parameters.
B.272. generic type¶
B.272:1 A generic type is a type with a generic parameter.
B.273. generic type alias¶
B.273:1 A generic type alias is a type alias with generic parameters.
B.274. generic union¶
B.274:1 A generic union is a union with generic parameters.
B.275. glob import¶
B.275:1 A glob import is a use import that brings all names with public visibility prefixed by its path prefix into scope.
B.275:2
See GlobImport
.
B.276. global path¶
B.276:1
A global path is a path that starts with namespace qualifier
::
.
B.277. global type variable¶
B.277:1 A global type variable is a type variable that can refer to any type.
B.278. greater-than expression¶
B.278:1 A greater-than expression is a comparison expression that tests for a greater-than relationship.
B.278:2
See GreaterThanExpression
.
B.279. greater-than-or-equals expression¶
B.279:1 A greater-than-or-equals expression is a comparison expression that tests for a greater-than-or-equals relationship.
B.279:2
See GreaterThanOrEqualsExpression
.
B.280. half-open range pattern¶
B.280:1 A half-open range pattern is a range pattern with only a range pattern low bound.
B.280:2
See HalfOpenRangePattern
.
B.281. hexadecimal literal¶
B.281:1 A hexadecimal literal is an integer literal in base 16.
B.281:2
See HexadecimalLiteral
.
B.282. higher-ranked trait bound¶
B.282:1 A higher-ranked trait bound is a bound that specifies an infinite list of bounds for all possible lifetimes.
B.282:2
See ForGenericParameterList
.
B.283. hygiene¶
B.283:1 Hygiene is a property of macros and identifiers` that appear within them, which aims to eliminate the syntactic interference between a macro and its environment.
B.284. hygienic¶
B.284:1 An identifier is hygienic when it has definition site hygiene.
B.285. i8¶
B.285:1
i8
is a signed integer type whose values range from - (27) to 27 - 1, all inclusive.
B.286. i16¶
B.286:1
i16
is a signed integer type whose values range from - (215) to 215 - 1, all inclusive.
B.287. i32¶
B.287:1
i32
is a signed integer type whose values range from - (231) to 231 - 1, all inclusive.
B.288. i64¶
B.288:1
i64
is a signed integer type whose values range from - (263) to 263 - 1, all inclusive.
B.289. i128¶
B.289:1
i128
is a signed integer type whose values range from - (2127) to 2127 - 1, all inclusive.
B.290. identifier¶
B.290:1 An identifier is a lexical element that refers to a name.
B.290:2
See Identifier
.
B.291. identifier pattern¶
B.291:1 An identifier pattern is a pattern that binds the value it matches to a binding.
B.291:2
See IdentifierPattern
.
B.292. if expression¶
B.292:1 An if expression is an expression that evaluates either a block expression or an else expression depending on the value of its subject expression.
B.292:2
See IfExpression
.
B.293. if let expression¶
B.293:1 An if let expression is an expression that evaluates either a block expression or an else expression depending on whether its pattern can be matched against its subject let expression.
B.293:2
See IfLetExpression
.
B.294. immutable¶
B.294:1 A value is immutable when it cannot be modified.
B.295. immutable borrow¶
B.295:1 An immutable borrow is an immutable reference produced by borrowing.
B.296. immutable borrow expression¶
B.296:1
An immutable borrow expression is a borrow expression that lacks
keyword mut
.
B.297. immutable place expression¶
B.297:1 An immutable place expression is a place expression whose memory location cannot be modified.
B.298. immutable place expression context¶
B.298:1 An immutable place expression context is a place expression context whose memory location cannot be modified.
B.299. immutable raw pointer type¶
B.299:1
An immutable raw pointer type is a raw pointer type subject to
keyword const
.
B.300. immutable reference¶
B.300:1 An immutable reference is a value of a shared reference type, and prevents the mutation of its referent.
B.301. immutable static¶
B.301:1 An immutable static is a static whose value cannot be modified.
B.302. immutable variable¶
B.302:1 An immutable variable is a variable whose value cannot be modified.
B.303. impl header lifetime elision¶
B.303:1 Impl header lifetime elision is a form of lifetime elision that applies to the implementing type and implemented trait (if any) of an implementation.
B.304. impl trait type¶
B.304:1 An impl trait type is a type that implements a trait, where the type is known at compile time.
B.304:2
See ImplTraitTypeSpecification
, ImplTraitTypeSpecificationOneBound
.
B.305. implementation¶
B.305:1 An implementation is an item that supplements an implementing type by extending its functionality.
B.305:2
See Implementation
.
B.306. implementation body¶
B.306:1 An implementation body is a construct that encapsulates the associated items, inner attributes, and inner doc comments of an implementation.
B.306:2
See ImplementationBody
.
B.307. implementation coherence¶
B.307:1 A trait implementation exhibits implementation coherence when it is valid and does not overlap with another trait implementation.
B.308. implementation conformance¶
B.308:1 Implementation conformance measures the compatibility between a trait implementation and the implemented trait.
B.309. implemented trait¶
B.309:1 An implemented trait is a trait whose functionality has been implemented by an implementing type.
B.309:2
See ImplementedTrait
.
B.310. implementing type¶
B.310:1 An implementing type is the type that the associated items of an implementation are associated with.
B.310:2
See ImplementingType
.
B.311. implicit borrow¶
B.311:1 An implicit borrow is a borrow that is not present syntactically in program text.
B.312. implicitly declared entity¶
B.312:1 An implicitly declared entity is an entity that lacks an explicit declaration.
B.313. implied bound¶
B.313:1 An implied bound is a bound that is not expressed in syntax, but is is the byproduct of relations between lifetime parameters and function parameters, between lifetime parameters and a return type, and between lifetime parameters and fields.
B.314. in scope¶
B.314:1 A name is in scope when it can be referred to.
B.315. inclusive range pattern¶
B.315:1 An inclusive range pattern is a range pattern with both a range pattern low bound and a range pattern high bound.
B.315:2
See InclusiveRangePattern
.
B.316. incomplete associated constant¶
B.316:1 An incomplete associated constant is an associated constant without a constant initializer.
B.317. incomplete associated function¶
B.317:1 An incomplete associated function is an associated function without a function body.
B.318. incomplete associated type¶
B.318:1 An incomplete associated type is an associated type without an initialization type.
B.319. index expression¶
B.319:1 An index expression is an expression that indexes into a value of a type.
B.319:2
See IndexExpression
.
B.320. indexable type¶
B.320:1
A indexable type is a type that implements the
core::ops::Index
trait.
B.321. indexed deconstructor¶
B.321:1 An indexed deconstructor is a construct that matches the position of a tuple field.
B.321:2
See IndexedDeconstructor
.
B.322. indexed field selector¶
B.322:1 An indexed field selector is a field selector where the selected field is indicated by an index.
B.322:2
See IndexedFieldSelector
.
B.323. indexed initializer¶
B.323:1 An indexed initializer is a construct that specifies the index and initial value of a field in a struct expression.
B.323:2
See IndexedInitializer
.
B.324. indexed operand¶
B.324:1
An indexed operand is an operand which indicates the value of a
type implementing core::ops::Index
being indexed into by an
index expression.
B.324:2
See IndexedOperand
.
B.325. indexing operand¶
B.325:1 An indexing operand is an operand which specifies the index for the indexed operand being indexed into by an index expression.
B.325:2
See IndexingOperand
.
B.326. indirection type¶
B.326:1 An indirection type is a type whose values refer to memory locations.
B.327. inert attribute¶
B.327:1 An inert attribute is an attribute that remains with the item it decorates.
B.328. inferred type¶
B.328:1 An inferred type is a placeholder for a type deduced by type inference.
B.328:2
See InferredType
.
B.329. infinite loop¶
B.329:1 For infinite loop, see infinite loop expression.
B.330. infinite loop expression¶
B.330:1 An infinite loop expression is a loop expression that continues to evaluate its loop body indefinitely.
B.330:2
See InfiniteLoopExpression
.
B.331. inherent implementation¶
B.331:1 An inherent implementation is an implementation that adds direct functionality.
B.331:2
See InherentImplementation
.
B.332. initialization¶
B.332:1 Initialization is the act of supplying an initial value to a constant, a static, or a variable.
B.333. initialization expression¶
B.333:1 An initialization expression is either a constant initializer or a static initializer.
B.334. initialization type¶
B.334:1 An initialization type is the type a type alias defines a name for.
B.334:2
See InitializationType
.
B.335. inline assembly¶
B.335:1 Inline assembly is hand-written assembly code that is integrated into a Rust program.
B.336. inline module¶
B.336:1
An inline module is a module with an InlineModuleSpecification
.
B.336:2
See InlineModuleSpecification
.
B.337. inner attribute¶
B.337:1 An inner attribute is an attribute that applies to an enclosing item.
B.337:2
See InnerAttribute
.
B.338. inner block doc¶
B.338:1 An inner block doc is a block comment that applies to an enclosing non-comment construct.
B.338:2
See InnerBlockDoc
.
B.339. inner doc comment¶
B.339:1 An inner doc comment is either an inner block doc or an inner line doc.
B.340. inner line doc¶
B.340:1 An inner line doc is a line comment that applies to an enclosing non-comment construct.
B.340:2
See InnerLineDoc
.
B.341. input register¶
B.341:1
An input register is a register whose register name is used in
a register argument subject to direction modifier in
, inout
,
or inlateout
.
B.342. input register expression¶
B.342:1 An input register expression is an expression that provides the initial value of a register.
B.342:2
See InputRegisterExpression
.
B.343. input-output register expression¶
B.343:1 An input-output register expression is a construct that specifies both an input register expression and an output register expression.
B.343:2
See InputOutputRegisterExpression
.
B.344. integer literal¶
B.344:1 An integer literal is a numeric literal that denotes a whole number.
B.344:2
See IntegerLiteral
.
B.345. integer suffix¶
B.345:1 An integer suffix is a component of an integer literal that specifies an explicit integer type.
B.345:2
See IntegerSuffix.
B.346. integer type¶
B.346:1 An integer type is a numeric type whose values denote whole numbers.
B.347. integer type variable¶
B.347:1 An integer type variable is a type variable that can refer only to integer types.
B.348. interior mutability¶
B.348:1 Interior mutability is a property of types whose values can be modified through immutable references.
B.349. intermediate match arm¶
B.349:1 An intermediate match arm is any non-final match arm of a match expression.
B.349:2
See IntermediateMatchArm
.
B.350. irrefutable constant¶
B.350:1 An irrefutable constant is a constant of a type that has at most one value.
B.351. irrefutable pattern¶
B.351:1 An irrefutable pattern is a pattern that always matches the value it is being matched against.
B.352. isize¶
B.352:1
isize
is a signed integer type with the same number of bits as the
platform’s pointer type, and is at least 16-bits wide.
B.353. item¶
B.353:1 An item is the most basic semantic element in program text. An item defines the compile- and run-time semantics of a program.
B.353:2
See Item
.
B.354. item scope¶
B.355. item statement¶
B.355:1 An item statement is a statement that is expressed as an item.
B.356. iteration expression¶
B.356:1 An iteration expression is an expression that provides the criterion of a while loop expression.
B.356:2
See IterationExpression
.
B.357. keyword¶
B.357:1 A keyword is a word in program text that has special meaning.
B.357:2
See Keyword
.
B.358. label¶
B.358:1 A label is the name of a loop expression.
B.358:2
See Label
.
B.359. label indication¶
B.359:1 A label indication is a construct that indicates a label.
B.359:2
See LabelIndication
.
B.360. label scope¶
B.361. layout¶
B.361:1 Layout specifies the alignment, size, and the relative offset of fields in a type.
B.362. lazy and expression¶
B.362:1 A lazy and expression is a lazy boolean expression that uses short circuit and arithmetic.
B.362:2
See LazyAndExpression
.
B.363. lazy boolean expression¶
B.363:1 A lazy boolean expression is an expression that performs short circuit Boolean arithmetic.
B.363:2
See LazyBooleanExpression
.
B.364. lazy or expression¶
B.364:1 A lazy or expression is a lazy boolean expression that uses short circuit or arithmetic.
B.364:2
See LazyOrExpression
.
B.365. left operand¶
B.365:1 A left operand is an operand that appears on the left-hand side of a binary operator.
B.365:2
See LeftOperand
.
B.366. less-than expression¶
B.366:1 A less-than expression is a comparison expression that tests for a less-than relationship.
B.366:2
See LessThanExpression
.
B.367. less-than-or-equals expression¶
B.367:1 A less-than-or-equals expression is a comparison expression that tests for a less-than-or-equals relationship.
B.367:2
See LessThanOrEqualsExpression
.
B.368. let initializer¶
B.368:1 A let initializer is a construct that provides the value of the bindings of the let statement using an expression, or alternatively executes a block expression.
B.368:2
See LetInitializer
.
B.369. let statement¶
B.369:1 A let statement is a statement that introduces new variables given by the bindings produced by its pattern-without-alternation that are optionally initialized to a value.
B.369:2
See LetStatement
.
B.370. lexical element¶
B.370:1 A lexical element is the most basic syntactic element in program text.
B.371. library crate¶
B.371:1
A library crate is a crate whose crate type is lib
, rlib
,
staticlib
, dylib
, or cdylib
.
B.372. lifetime¶
B.372:1 A lifetime specifies the expected longevity of a reference.
B.372:2
See Lifetime
.
B.373. lifetime argument¶
B.373:1 A lifetime argument is a generic argument that supplies the value of a lifetime parameter.
B.373:2
See LifetimeArgument
.
B.374. lifetime bound¶
B.374:1 A lifetime bound is a bound that imposes a constraint on the lifetimes of generic parameters.
B.374:2
See LifetimeIndication
.
B.375. lifetime bound predicate¶
B.375:1 A lifetime bound predicate is a construct that specifies lifetime bounds on a lifetime parameter.
B.375:2
See LifetimeBoundPredicate
.
B.376. lifetime elision¶
B.376:1 Lifetime elision is a set of rules that automatically insert lifetime parameters and/or lifetime arguments when they are elided in the source code.
B.377. lifetime parameter¶
B.377:1 A lifetime parameter is a generic parameter for a lifetime.
B.377:2
See LifetimeParameter
.
B.378. lifetime variable¶
B.378:1 A lifetime variable is a placeholder used during type inference to stand in for an undetermined lifetime of a type.
B.379. line¶
B.379:1 A line is a sequence of zero or more characters followed by an end of line.
B.380. line comment¶
B.380:1 A line comment is a comment that spans exactly one line.
B.380:2
See LineComment
.
B.381. literal¶
B.381:1 A literal is a fixed value in program text.
B.381:2
See Literal
.
B.382. literal expression¶
B.382:1 A literal expression is an expression that denotes a literal.
B.382:2
See LiteralExpression
.
B.383. literal pattern¶
B.383:1 A literal pattern is a pattern that matches a literal.
B.383:2
See LiteralPattern
.
B.384. local trait¶
B.384:1 A local trait is a trait that is defined in the current crate.
B.385. local type¶
B.385:1 A local type is a type that is defined in the current crate.
B.386. local variable¶
B.386:1 For local variable, see variable.
B.387. loop¶
B.387:1 For loop, see loop expression.
B.388. loop body¶
B.388:1 A loop body is the block expression of a loop expression.
B.388:2
See LoopBody
.
B.389. loop expression¶
B.389:1 A loop expression is an expression that evaluates a block expression continuously as long as some criterion holds true.
B.389:2
See LoopExpression
.
B.390. macro¶
B.390:1 A macro is a custom definition that extends Rust by defining callable syntactic transformations.
B.391. macro expansion¶
B.391:1 Macro expansion is the process of statically executing a macro invocation and replacing it with the produced output of the macro invocation.
B.392. macro implementation function¶
B.392:1 A macro implementation function is the function that encapsulates the syntactic transformations of a procedural macro.
B.393. macro invocation¶
B.393:1 A macro invocation is a call of a declarative macro or function-like macro that is expanded statically and replaced with the result of the macro.
B.393:2
See MacroInvocation
.
B.394. macro match¶
B.394:1 A macro match is the most basic form of a satisfied macro matcher.
B.394:2
See MacroMatch
.
B.395. macro matcher¶
B.395:1 A macro matcher is a construct that describes a syntactic pattern that a macro must match.
B.395:2
See MacroMatcher
.
B.396. macro matching¶
B.396:1 Macro matching is the process of performing rule matching and token matching.
B.397. macro repetition¶
B.397:1 A macro repetition is either a macro repetition in matching or a macro repetition in transcription.
B.398. macro repetition in matching¶
B.398:1 A macro repetition in matching allows for a syntactic pattern to be matched zero or multiple times during macro matching.
B.398:2
See MacroRepetitionMatch
.
B.399. macro repetition in transcription¶
B.399:1 A macro repetition in transcription allows for a syntactic pattern to be transcribed zero or multiple times during macro transcription.
B.399:2
See MacroRepetitionTranscriber
.
B.400. macro rule¶
B.400:1 A macro rule is a construct that consists of a macro matcher and a macro transcriber.
B.400:2
See MacroRule
.
B.401. macro statement¶
B.401:1 A macro statement is a statement expressed as a terminated macro invocation.
B.402. macro transcriber¶
B.402:1 A macro transcriber is a construct that describes the replacement syntax of a macro.
B.402:2
See MacroTranscriber
.
B.403. macro transcription¶
B.403:1 Macro transcription is the process of producing the expansion of a declarative macro.
B.404. main function signature¶
B.404:1 A main function signature is a function signature subject to specific restrictions.
B.405. match arm¶
B.405:1 A match arm is a construct that consists of a match arm matcher and a match arm body.
B.406. match arm body¶
B.407. match arm guard¶
B.407:1 A match arm guard is a construct that provides additional filtering to a match arm matcher.
B.407:2
See MatchArmGuard
.
B.408. match arm matcher¶
B.408:1 A match arm matcher is a construct that consists of a pattern and a match arm guard.
B.408:2
See MatchArmMatcher
.
B.409. match expression¶
B.409:1 A match expression is an expression that tries to match one of its multiple patterns against its subject expression and if it succeeds, evaluates an operand.
B.409:2
See MatchExpression
.
B.410. metavariable¶
B.410:1 A metavariable is a macro match that describes a variable.
B.410:2
See MacroMetavariable
.
B.411. metavariable indication¶
B.411:1 A metavariable indication is a construct that indicates a metavariable.
B.411:2
See MacroMetavariableIndication
.
B.412. method¶
B.412:1 A method is an associated function with a self parameter.
B.413. method call expression¶
B.413:1 A method call expression is an expression that invokes a method of a variable.
B.413:2
See MethodCallExpression
.
B.414. method operand¶
B.414:1 A method operand is an operand that denotes the method being invoked by a method call expression.
B.414:2
See MethodOperand
.
B.415. method resolution¶
B.415:1 Method resolution is a kind of resolution that applies to a method call expression.
B.416. mixed site hygiene¶
B.416:1
Mixed site hygiene is a type of hygiene which resolves to the
MacroRulesDeclaration
site for variables, labels, and the
$crate
metavariable, and to the MacroInvocation
site otherwise,
and is considered partially hygienic.
B.417. modifying operand¶
B.417:1 A modifying operand is an operand that supplies the value that is used in the calculation of a compound assignment expression.
B.417:2
See ModifyingOperand
.
B.418. module¶
B.418:1 A module is a container for zero or more items.
B.418:2
See ModuleDeclaration
.
B.419. move type¶
B.419:1
A move type is a type that implements the core::marker::Sized
trait and that is not a copy type.
B.420. multi segment path¶
B.420:1 A multi segment path is a path consisting of more than one path segment.
B.421. multiplication assignment¶
B.421:1 For multiplication assignment, see multiplication assignment expression.
B.422. multiplication assignment expression¶
B.422:1 A multiplication assignment expression is a compound assignment expression that uses multiplication.
B.422:2
See MultiplicationAssignmentExpression
.
B.423. multiplication expression¶
B.423:1 A multiplication expression is an arithmetic expression that uses multiplication.
B.423:2
See MultiplicationExpression
.
B.424. mutability¶
B.424:1 Mutability determines whether a construct can modify a value.
B.425. mutable¶
B.425:1 A value is mutable when it can be modified.
B.426. mutable assignee expression¶
B.426:1 A mutable assignee expression is an assignee expression whose value can be modified.
B.427. mutable binding¶
B.427:1 A mutable binding is a binding whose value can be modified.
B.428. mutable borrow¶
B.428:1 A mutable borrow is a mutable reference produced by borrowing.
B.429. mutable borrow expression¶
B.429:1
A mutable borrow expression is a borrow expression that has
keyword mut
.
B.430. mutable place expression¶
B.430:1 A mutable place expression is a place expression whose memory location can be modified.
B.431. mutable place expression context¶
B.431:1 A mutable place expression context is a place expression context that may evaluate its operand as a mutable memory location.
B.432. mutable raw pointer type¶
B.432:1
A mutable raw pointer type is a raw pointer type subject to
keyword mut
.
B.433. mutable reference¶
B.433:1 A mutable reference is a value of a mutable reference type, and allows the mutation of its referent.
B.434. mutable reference type¶
B.434:1
A mutable reference type is a reference type subject to keyword
mut
.
B.435. mutable static¶
B.435:1 A mutable static is a static whose value can be modified.
B.436. mutable variable¶
B.436:1 A mutable variable is a variable whose value can be modified.
B.437. name¶
B.437:1 A name is an identifier that refers to an entity.
B.437:2
See Name
.
B.438. named block expression¶
B.438:1 A named block expression is a block expression with a label.
B.439. named deconstructor¶
B.439:1 A named deconstructor is a construct that matches the name of a field.
B.439:2
See NamedDeconstructor
.
B.440. named field selector¶
B.440:1 A named field selector is a field selector where the selected field is indicated by an identifier.
B.440:2
See NamedFieldSelector
.
B.441. named initializer¶
B.441:1 A named initializer is a construct that specifies the name and initial value of a field in a struct expression.
B.441:2
See NamedInitializer
.
B.442. named loop expression¶
B.442:1 A named loop expression is a loop expression with a label.
B.443. named register argument¶
B.443:1 A named register argument is a register argument whose configuration is bound to an identifier.
B.444. namespace¶
B.444:1 A namespace is a logical grouping of names such that the occurrence of a name in one namespace does not conflict with an occurrence of the same name in another namespace.
B.445. NaN-boxing¶
B.445:1
NaN-boxing is a technique for encoding values using the low order
bits of the mantissa of a 64-bit IEEE floating-point NaN
.
B.446. negation expression¶
B.446:1 A negation expression is an expression that negates its operand.
B.446:2
See NegationExpression
.
B.447. nesting import¶
B.447:1 A nesting import is a use import that provides a common path prefix for its nested use imports.
B.447:2
See NestingImport
.
B.448. never type¶
B.448:1 The never type is a type that represents the result of a computation that never completes.
B.448:2
See NeverType
.
B.449. non-reference pattern¶
B.449:1 A non-reference pattern is any pattern except non-binding patterns, path patterns, reference patterns, and underscore patterns.
B.450. not configuration predicate¶
B.450:1 A not configuration predicate is a configuration predicate that negates the Boolean value of its nested configuration predicate.
B.450:2
See ConfigurationPredicateNot
.
B.451. not-equals expression¶
B.451:1 A not-equals expression is a comparison expression that tests for inequality.
B.451:2
See NotEqualsExpression
.
B.452. null¶
B.452:1
A null
value denotes the address 0
.
B.453. numeric literal¶
B.453:1 A numeric literal is a literal that denotes a number.
B.453:2
See NumericLiteral
.
B.454. numeric literal pattern¶
B.454:1 A numeric literal pattern is a pattern that matches a numeric literal.
B.454:2
See LiteralPattern
.
B.455. numeric type¶
B.455:1 A numeric type is a type whose values denote numbers.
B.456. object safe¶
B.456:1 A trait is object safe when it can be used as a trait object type.
B.457. object safety¶
B.457:1 Object safety is the process of determining whether a trait can be used as a trait object type.
B.458. obsolete range pattern¶
B.458:1 An obsolete range pattern is a range pattern that uses obsolete syntax to express an inclusive range pattern.
B.458:2
See ObsoleteRangePattern
.
B.459. octal literal¶
B.459:1 An octal literal is an integer literal in base 8.
B.459:2
See OctalLiteral.
B.460. operand¶
B.460:1 An operand is an expression nested within an expression.
B.460:2
See Operand
.
B.461. operator expression¶
B.461:1 An operator expression is an expression that involves an operator.
B.461:2
See OperatorExpression
.
B.462. opt-out trait bound¶
B.462:1
An opt-out trait bound is a trait bound with Punctuation
?
that nullifies an implicitly added trait bound.
B.463. outer attribute¶
B.463:1 An outer attribute is an attribute that applies to a subsequent item.
B.463:2
See OuterAttribute
.
B.464. outer block doc¶
B.464:1 An outer block doc is a block comment that applies to a subsequent non-comment construct.
B.464:2
See OuterBlockDoc
.
B.465. outer doc comment¶
B.465:1 An outer doc comment is either an outer block doc or an outer line doc.
B.466. outer line doc¶
B.466:1 An outer line doc is a line comment that applies to a subsequent non-comment construct.
B.466:2
See OuterLineDoc
.
B.467. outline module¶
B.467:1
An outline module is a module with an
OutlineModuleSpecification
.
B.467:2
See OutlineModuleSpecification
.
B.468. outlives bound¶
B.468:1 An outlives bound is a trait bound which requires that a generic parameter outlives a lifetime parameter.
B.469. output register¶
B.469:1
An output register is a register whose register name is
used in a register argument subject to direction modifier out
,
lateout
, inout
, or inlateout
.
B.470. output register expression¶
B.470:1 An output register expression is an expression that is assigned the value of a register.
B.470:2
See OutputRegisterExpression
.
B.471. overlap¶
B.471:1 Two values overlap when their memory locations overlap, or both values are elements of the same array.
B.472. owner¶
B.473. ownership¶
B.473:1 Ownership is a property of values that is central to the resource management model of Rust.
B.474. panic¶
B.474:1
A panic is an abnormal program state caused by invoking macro
core::panic
.
B.475. parenthesized expression¶
B.475:1 A parenthesized expression is an expression that groups other expressions.
B.475:2
See ParenthesizedExpression
.
B.476. parenthesized pattern¶
B.476:1 A parenthesized pattern is a pattern that controls the precedence of its subpatterns.
B.476:2
See ParenthesizedPattern
.
B.477. parenthesized type¶
B.477:1 A parenthesized type is a type that disambiguates the interpretation of lexical elements.
B.477:2
See ParenthesizedTypeSpecification
.
B.478. partially hygienic¶
B.478:1 An identifier is partially hygienic when it has mixed site hygiene.
B.479. passing convention¶
B.479:1 A passing convention is the mechanism that defines how a value is transferred between places.
B.480. path¶
B.480:1
A path is a sequence of path segments logically separated by
namespace qualifier ::
that resolves to an entity.
B.481. path expression¶
B.481:1 A path expression is a path that acts as an expression.
B.481:2
See PathExpression
.
B.482. path expression resolution¶
B.482:1 Path expression resolution is a form of path resolution that applies to a path expression.
B.483. path pattern¶
B.483:1 A path pattern is a pattern that matches a constant, a unit enum variant, or a unit struct constant indicated by a path.
B.483:2
See PathPattern
.
B.484. path resolution¶
B.484:1 Path resolution is a form of resolution that applies to a path.
B.485. path segment¶
B.485:1 A path segment is a constituent of a path.
B.485:2
See PathSegment
, SimplePathSegment
, TypePathSegment
.
B.486. pattern¶
B.486:1 A pattern is a construct that matches a value which satisfies all the criteria of the pattern.
B.486:2
See Pattern
.
B.487. pattern matching¶
B.487:1 Pattern matching is the process of matching a pattern against a value.
B.488. pattern-without-alternation¶
B.488:1 A pattern-without-alternation is a pattern that cannot be alternated.
B.488:2
See PatternWithoutAlternation
.
B.489. pattern-without-range¶
B.489:1 A pattern-without-range is a pattern-without-alternation that excludes range patterns.
B.489:2
See PatternWithoutRange
.
B.490. place¶
B.490:1 A place is a location where a value resides.
B.491. place expression¶
B.491:1 A place expression is an expression that represents a memory location.
B.492. place expression context¶
B.492:1 A place expression context is a construct that may evaluate its operand as a memory location.
B.493. plane¶
B.493:1 In Unicode, a plane is a continuous group of 65,536 code points.
B.494. pointer¶
B.494:1 A pointer is a value of a pointer type.
B.495. pointer type¶
B.495:1 A pointer type is a type whose values indicate memory locations.
B.496. positional register argument¶
B.496:1 A positional register argument is a register argument whose configuration is not bound to an identifier.
B.497. precedence¶
B.497:1 Precedence is the order by which expressions are evaluated in the presence of other expressions.
B.498. prelude¶
B.498:1 A prelude is a collection of entities that are automatically brought in scope of every module in a crate.
B.499. prelude entity¶
B.499:1 A prelude entity is an entity declared in a prelude.
B.500. prelude name¶
B.500:1 A prelude name is a name of a prelude entity.
B.501. primitive representation¶
B.501:1 Primitive representation is the type representation of integer types.
B.502. principal trait¶
B.502:1 The principal trait of trait object type is its first trait bound.
B.503. private visibility¶
B.503:1 Private visibility is a kind of visibility that allows a name to be referred to only by the current module of the entity, and its descendant modules.
B.504. proc-macro crate¶
B.504:1
A proc-macro crate is a crate whose crate type is proc-macro
.
B.505. procedural macro¶
B.505:1 A procedural macro is a macro that encapsulates syntactic transformations in a function.
B.506. program entry point¶
B.506:1 A program entry point is a function that is invoked at the start of a Rust program.
B.507. public visibility¶
B.507:1
Public visibility is a kind of visibility that allows a name
to be referred to from arbitrary module M
as long as the ancestor
modules of the related entity can be referred to from M
.
B.508. punctuator¶
B.508:1
A punctuator is a character or a sequence of characters in category
Punctuation
.
B.509. pure identifier¶
B.509:1 A pure identifier is an identifier that does not include weak keywords.
B.510. qualified path expression¶
B.510:1 A qualified path expression is a path expression that resolves through a qualified type.
B.510:2
See QualifiedPathExpression
.
B.511. qualified type¶
B.511:1 A qualified type is a type that is restricted to a set of implementations that exhibit implementation conformance to a qualifying trait.
B.511:2
See QualifiedType
.
B.512. qualified type path¶
B.512:1 A qualified type path is a type path that resolves through a qualified type.
B.512:2
See QualifiedTypePath
.
B.513. qualifying trait¶
B.513:1 A qualifying trait is a trait that imposes a restriction on a qualified type.
B.513:2
See QualifyingTrait
.
B.514. range expression¶
B.514:1 A range expression is an expression that constructs a range.
B.514:2
See RangeExpression
.
B.515. range expression high bound¶
B.515:1 A range expression high bound is an operand that specifies the end of a range.
B.515:2
See RangeExpressionHighBound
.
B.516. range expression low bound¶
B.516:1 A range expression low bound is an operand that specifies the start of a range.
B.516:2
See RangeExpressionLowBound
.
B.517. range pattern¶
B.517:1 A range pattern is a pattern that matches values which fall within a range.
B.517:2
See RangePattern
.
B.518. range pattern bound¶
B.518:1 A range pattern bound is a constraint on the range of a range pattern.
B.518:2
See RangePatternBound
.
B.519. range pattern high bound¶
B.519:1 A range pattern high bound is a range pattern bound that specifies the end of a range.
B.519:2
See RangePatternHighBound
.
B.520. range pattern low bound¶
B.520:1 A range pattern low bound is a range pattern bound that specifies the start of a range.
B.520:2
See RangePatternLowBound
.
B.521. range-from expression¶
B.521:1 A range-from expression is a range expression that specifies an included range expression low bound.
B.521:2
See RangeFromExpression
.
B.522. range-from-to expression¶
B.522:1 A range-from-to expression is a range expression that specifies an included range expression low bound and an excluded range expression high bound.
B.522:2
See RangeFromToExpression
.
B.523. range-full expression¶
B.523:1 A range-full expression is a range expression that covers the whole range of a type.
B.523:2
See RangeFullExpression
.
B.524. range-inclusive expression¶
B.524:1 A range-inclusive expression is a range expression that specifies an included range expression low bound and an included range expression high bound.
B.524:2
See RangeInclusiveExpression
.
B.525. range-to expression¶
B.525:1 A range-to expression is a range expression that specifies an excluded range expression high bound.
B.525:2
See RangeToExpression
.
B.526. range-to-inclusive expression¶
B.526:1 A range-to-inclusive expression is a range expression that specifies an included range expression high bound.
B.526:2
See RangeToInclusiveExpression
.
B.527. raw byte string literal¶
B.527:1 A raw byte string literal is a simple byte string literal that does not recognize escaped characters.
B.527:2
See RawByteStringLiteral
.
B.528. raw c string literal¶
B.528:1 A raw c string literal is a simple c string literal that does not recognize escaped characters.
B.528:2
See RawCStringLiteral
.
B.529. raw pointer¶
B.529:1 A raw pointer is a pointer of a raw pointer type.
B.530. raw pointer type¶
B.530:1 A raw pointer type is an indirection type without safety and liveness guarantees.
B.530:2
See RawPointerTypeSpecification
.
B.531. raw string literal¶
B.531:1 A raw string literal is a simple string literal that does not recognize escaped characters.
B.531:2
See RawStringLiteral
.
B.532. reachable control flow path¶
B.532:1 A reachable control flow path is a control flow path that can be taken by the execution of a program between two given points in the program.
B.533. receiver operand¶
B.533:1 A receiver operand is an operand that denotes the value whose method is being invoked by a method call expression.
B.533:2
See ReceiverOperand
.
B.534. receiver type¶
B.534:1 A receiver type is the type of a receiver operand.
B.535. record enum variant¶
B.535:1
A record enum variant is an enum variant with a
RecordStructFieldList
.
B.536. record struct¶
B.536:1
A record struct is a struct with a RecordStructFieldList
.
B.536:2
See RecordStructDeclaration
.
B.537. record struct field¶
B.537:1 A record struct field is a field of a record struct type.
B.537:2
See RecordStructField
.
B.538. record struct pattern¶
B.538:1 A record struct pattern is a pattern that matches a enum variant value, a struct value, or a union value.
B.538:2
See RecordStructPattern
.
B.539. record struct type¶
B.539:1 A record struct type is the type of a record struct.
B.540. record struct value¶
B.540:1 A record struct value is a value of a record struct type.
B.541. recursive type¶
B.541:1 A recursive type is a type that may define other types within its type specification.
B.542. reference¶
B.542:1 A reference is a value of a reference type.
B.543. reference identifier pattern¶
B.543:1
A reference identifier pattern is an identifier pattern with
keyword ref
.
B.544. reference pattern¶
B.544:1 A reference pattern is a pattern that dereferences a pointer that is being matched.
B.544:2
See ReferencePattern
.
B.545. reference type¶
B.545:1 A reference type is an indirection type with ownership.
B.545:2
See ReferenceTypeSpecification
.
B.546. referent¶
B.547. refutability¶
B.547:1 Refutability is a property of patterns that expresses the ability to match all possible values of a type.
B.548. refutable constant¶
B.548:1 A refutable constant is a constant of a refutable type.
B.549. refutable pattern¶
B.549:1 A refutable pattern is a pattern that has a possibility of not matching the value it is being matched against.
B.550. refutable type¶
B.550:1 A refutable type is a type that has more than one value.
B.551. register¶
B.551:1 A register is a hardware component capable of holding data that can be read and written.
B.552. register argument¶
B.552:1 A register argument is a construct that configures the input and output of a register, and optionally binds the configuration to an identifier.
B.552:2
See RegisterArgument
.
B.553. register class¶
B.553:1 A register class represents a set of registers.
B.554. register class argument¶
B.554:1 A register class argument is a register argument that uses a register class name.
B.555. register class name¶
B.555:1 A register class name is a target-specific string that identifies a register class.
B.555:2
See RegisterClassName
.
B.556. register expression¶
B.556:1 A register expression is either an input-output register expression or a simple register expression.
B.556:2
See RegisterExpression
.
B.557. register name¶
B.557:1 A register name is either the explicit register name of a register, or the register class name of the register class a register belongs to.
B.557:2
See RegisterName
.
B.558. register parameter¶
B.558:1 A register parameter is a substring delimited by characters 0x7B (left curly bracket) and 0x7D (right curly bracket) that is substituted with a register argument in an assembly instruction.
B.559. register parameter modifier¶
B.559:1 A register parameter modifier is a substring that starts with character 0x3A (colon), follows a register parameter, and changes the formatting of the related register parameter.
B.560. remainder assignment¶
B.560:1 For remainder assignment, see remainder assignment expression.
B.561. remainder assignment expression¶
B.561:1 A remainder assignment expression is a compound assignment expression that uses remainder division.
B.561:2
See RemainderAssignmentExpression
.
B.562. remainder expression¶
B.562:1 A remainder expression is an arithmetic expression that uses remainder division.
B.562:2
See RemainderExpression
.
B.563. renaming¶
B.563:1 A renaming provides an alternative name for an existing name.
B.563:2
See Renaming
.
B.564. repeat operand¶
B.564:1 A repeat operand is an operand that specifies the element being repeated in an array repetition constructor.
B.564:2
See RepeatOperand
.
B.565. repetition operator¶
B.565:1 A repetition operator is a construct that indicates the number of times a macro repetition in matching or a macro repetition in transcription can be repeated.
B.565:2
See MacroRepetitionOperator
.
B.566. representation¶
B.566:1 See type representation.
B.567. representation modifier¶
B.567:1 A representation modifier is a construct that modifies the alignment of a type.
B.567:2
See Alignment
.
B.568. reserved keyword¶
B.568:1 A reserved keyword is a keyword that is not yet in use.
B.568:2
See ReservedKeyword
.
B.569. resolution¶
B.569:1 Resolution is the process of finding a unique interpretation for a field access expression, a method call expression, or a path.
B.570. rest pattern¶
B.570:1 A rest pattern is a pattern that matches zero or more elements that have not already been matched.
B.570:2
See RestPattern
.
B.571. return expression¶
B.571:1 A return expression is an expression that optionally yields a value and causes control flow to return to the caller.
B.571:2
See ReturnExpression
.
B.572. return type¶
B.572:1 A return type is the type of the result a function returns.
B.572:2
See ReturnType
.
B.573. right operand¶
B.573:1 A right operand is an operand that appears on the right-hand side of a binary operator.
B.573:2
See RightOperand
.
B.574. rule matching¶
B.574:1
Rule matching is the process of consuming a TokenTree
in an attempt
to fully satisfy the macro matcher of a macro rule that belongs to a
resolved declarative macro.
B.575. rustc¶
B.575:1 Rust-c (or rustc) is a compiler that implements the Ferrocene Language Specification.
B.576. safety invariant¶
B.576:1 A safety invariant is an invariant that when violated may result in undefined behavior.
B.577. scalar type¶
B.577:1
A scalar type is either a bool
type, a char
type, or
a numeric type.
B.578. scope¶
B.578:1 A scope is a region of program text where a name can be referred to.
B.579. scope hierarchy¶
B.579:1 The scope hierarchy reflects the nesting of scopes as introduced by scoping constructs.
B.580. selected field¶
B.580:1 A selected field is a field that is selected by a field access expression.
B.581. Self¶
B.581:1
Self
is either an implicit type parameter in traits or an
implicit type alias in implementations. Self
refers to the
type that implements a trait.
B.582. self parameter¶
B.582:1
A self parameter is a function parameter expressed by keyword
self
.
B.583. self public modifier¶
B.583:1 A self public modifier is a visibility modifier that grants a name private visibility.
B.583:2
See SelfPublicModifier
.
B.584. Self scope¶
B.585. send type¶
B.585:1
A send type is a type that implements the core::marker::Send
trait.
B.586. separator¶
B.586:1 A separator is a character or a string that separates adjacent lexical elements.
B.587. sequence type¶
B.587:1 A sequence type represents a sequence of elements.
B.588. shadowing¶
B.588:1 Shadowing is a property of names. A name is said to be shadowed when another name with the same characters is introduced in the same scope within the same namespace, effectively hiding it.
B.592. shift left assignment¶
B.592:1 For shift left assignment, see shift left assignment expression.
B.593. shift left assignment expression¶
B.593:1 A shift left assignment expression is a compound assignment expression that uses bit shift left arithmetic.
B.593:2
See ShiftLeftAssignmentExpression
.
B.594. shift left expression¶
B.594:1 A shift left expression is a bit expression that uses bit shift left arithmetic.
B.594:2
See ShiftLeftExpression
.
B.595. shift right assignment¶
B.595:1 For shift right assignment, see shift right assignment expression.
B.596. shift right assignment expression¶
B.596:1 A shift right assignment expression is a compound assignment expression that uses bit shift right arithmetic.
B.596:2
See ShiftRightAssignmentExpression
.
B.597. shift right expression¶
B.597:1 A shift right expression is a bit expression that uses bit shift right arithmetic.
B.597:2
See ShiftRightExpression
.
B.598. shorthand deconstructor¶
B.598:1 A shorthand deconstructor is a construct that matches the name of a field and binds the value of the matched field to a binding.
B.598:2
See ShorthandDeconstructor
.
B.599. shorthand initializer¶
B.599:1 A shorthand initializer is a construct that specifies the name of a field in a struct expression.
B.599:2
See ShorthandInitializer
.
B.600. signed integer type¶
B.600:1 A signed integer type is an integer type whose values denote negative whole numbers, zero, and positive whole numbers.
B.601. simple byte string literal¶
B.601:1
A simple byte string literal is a byte string literal that consists
of multiple AsciiCharacters
.
B.601:2
See SimpleByteStringLiteral
.
B.602. simple c string literal¶
B.602:1 A simple c string literal is any Unicode character except characters 0x0D (carriage return), 0x22 (quotation mark), 0x5C (reverse solidus) and 0x00 (null byte).
B.602:2
See SimpleCStringLiteral
.
B.603. simple import¶
B.603:1 A simple import is a use import that binds a simple path to a local name by using an optional renaming.
B.603:2
See SimpleImport
.
B.604. simple path¶
B.604:1 A simple path is a path whose path segments consist of either identifiers or certain keywords.
B.604:2
See SimplePath
.
B.605. simple path prefix¶
B.605:1 A simple path prefix is the leading simple path of a glob import or a nesting import.
B.605:2
See SimplePathPrefix
.
B.606. simple path public modifier¶
B.606:1 A simple path public modifier is a visibility modifier that grants a name public visibility within the provided simple path only.
B.606:2
See SimplePathPublicModifier
.
B.607. simple path resolution¶
B.607:1 Simple path resolution is a kind of path resolution that applies to a simple path.
B.608. simple public modifier¶
B.608:1 A simple public modifier is a visibility modifier that grants a name public visibility.
B.608:2
See SelfPublicModifier
.
B.609. simple register expression¶
B.609:1 A simple register expression is either an expression or an underscore expression.
B.609:2
See SimpleRegisterExpression
.
B.610. simple string literal¶
B.610:1 A simple string literal is a string literal where the characters are Unicode characters.
B.610:2
See SimpleStringLiteral
.
B.611. single segment path¶
B.611:1 A single segment path is a path consisting of exactly one path segment.
B.612. size¶
B.612:1 The size of a value is the offset in bytes between successive elements in an array type with the same element type, including any padding for alignment.
B.613. size operand¶
B.613:1 A size operand is an operand that specifies the size of an array or an array type.
B.613:2
See SizeOperand
.
B.614. sized type¶
B.614:1 A sized type is a type with statically known size.
B.615. slice¶
B.615:1 A slice is a value of a slice type.
B.616. slice pattern¶
B.616:1 A slice pattern is a pattern that matches arrays of fixed size and slices of dynamic size.
B.616:2
See SlicePattern
.
B.617. slice type¶
B.617:1 A slice type is a sequence type that provides a view into a sequence of elements.
B.617:2
See SliceTypeSpecification
.
B.618. source file¶
B.618:1 A source file contains the program text of inner attributes, inner doc comments, and items.
B.618:2
See SourceFile
.
B.619. statement¶
B.619:1 A statement is a component of a block expression.
B.619:2
See Statement
.
B.620. static¶
B.620:1 A static is a value that is associated with a specific memory location.
B.620:2
See StaticDeclaration
.
B.621. static initializer¶
B.621:1 A static initializer is a construct that provides the value of its related static.
B.621:2
See StaticInitializer
.
B.622. static lifetime elision¶
B.622:1 Static lifetime elision is a form of lifetime elision that applies to constants and statics.
B.623. str¶
B.623:1
str
is a sequence type that represents a slice of 8-bit
unsigned bytes.
B.624. strict keyword¶
B.624:1 A strict keyword is a keyword that always holds its special meaning.
B.624:2
See StrictKeyword
.
B.625. string literal¶
B.625:1 A string literal is a literal that consists of multiple characters.
B.625:2
See StringLiteral
.
B.626. struct¶
B.626:1 A struct is an item that declares a struct type.
B.627. struct expression¶
B.627:1 A struct expression is an expression that constructs an enum value, a struct value, or a union value.
B.627:2
See StructExpression
.
B.628. struct field¶
B.628:1 A struct field is a field of a struct type.
B.629. struct pattern¶
B.629:1 A struct pattern is a pattern that matches an enum value, a struct value, or a union value.
B.629:2
See StructPattern
.
B.630. struct type¶
B.630:1 A struct type is an abstract data type that is a product of other types.
B.630:2
See StructDeclaration
.
B.631. struct value¶
B.631:1 A struct value is a value of a struct type.
B.632. structurally equal¶
B.632:1 A type is structurally equal when its values can be compared for equality by structure.
B.633. subexpression¶
B.633:1 A subexpression is an expression nested within another expression.
B.634. subject expression¶
B.634:1 A subject expression is an expression that controls for loops, if expressions, and match expressions.
B.634:2
See SubjectExpression
.
B.635. subject let expression¶
B.635:1 A subject let expression is an expression that controls if let expressions and while let loops.
B.635:2
See SubjectLetExpression
.
B.636. subpattern¶
B.636:1 A subpattern is a pattern nested within another pattern.
B.637. subtraction assignment¶
B.637:1 For subtraction assignment, see subtraction assignment.
B.638. subtraction assignment expression¶
B.638:1 A subtraction assignment expression is a compound assignment expression that uses subtraction.
B.638:2
See SubtractionAssignmentExpression
.
B.639. subtraction expression¶
B.639:1 A subtraction expression is an arithmetic expression that uses subtraction.
B.639:2
See SubtractionExpression
.
B.640. subtrait¶
B.640:1 A subtrait is a trait with a supertrait.
B.641. subtype¶
B.641:1 A subtype is a type with additional constraints.
B.642. subtyping¶
B.642:1 Subtyping is a property of types, allowing one type to be used where another type is expected.
B.643. suffixed float¶
B.643:1 A suffixed float is a float literal with a float suffix.
B.644. suffixed integer¶
B.644:1 A suffixed integer is an integer literal with an integer suffix.
B.645. super public modifier¶
B.645:1 A super public modifier is a visibility modifier that grants a name public visibility within the parent module only.
B.645:2
See SuperPublicModifier
.
B.646. supertrait¶
B.646:1 A supertrait is a transitive trait that a type must additionally implement.
B.647. sync type¶
B.647:1
A sync type is a type that implements the core::marker::Sync
trait.
B.648. syntactic category¶
B.648:1 A syntactic category is a nonterminal in the Backus-Naur Form grammar definition of the Rust programming language.
B.649. tail expression¶
B.649:1 A tail expression is the last expression within a block expression.
B.650. temporary¶
B.650:1 A temporary is an anonymous variable produced by some intermediate computation.
B.651. terminated¶
B.651:1 A loop expression is terminated when its block expression is no longer evaluated.
B.652. terminated macro invocation¶
B.652:1 A terminated macro invocation is a macro invocation that may be used as a statement.
B.652:2
See TerminatedMacroInvocation
.
B.653. textual macro scope¶
B.653:1 A textual macro scope is a scope for declarative macros.
B.654. textual type¶
B.654:1
A textual type is a type class that includes type char
and type
str
.
B.655. thin pointer¶
B.655:1 A thin pointer is a value of a thin pointer type.
B.656. thin pointer type¶
B.656:1 A thin pointer type is an indirection type that refers to a fixed sized type.
B.657. token matching¶
B.657:1
Token matching is the process of consuming a TokenTree
in an attempt
to fully satisfy a macro match of a selected macro matcher that
belongs to a resolved declarative macro.
B.658. tokens¶
B.658:1 Tokens are a subset of lexical elements consumed by macros.
B.659. trait¶
B.659:1 A trait is an item that describes an interface a type can implement.
B.659:2
See TraitDeclaration
.
B.660. trait body¶
B.660:1 A trait body is a construct that encapsulates the associated items, inner attributes, and inner doc comments of a trait.
B.660:2
See TraitBody
.
B.661. trait bound¶
B.661:1 A trait bound is a bound that imposes a constraint on the traits of generic parameters.
B.661:2
See TraitBound
.
B.662. trait implementation¶
B.662:1 A trait implementation is an implementation that adds functionality specified by a trait.
B.662:2
See TraitImplementation
.
B.663. trait object lifetime elision¶
B.663:1 Trait object lifetime elision is a form of lifetime elision that applies to trait object types.
B.664. trait object type¶
B.664:1 A trait object type is a type that implements a trait, where the type is not known at compile time.
B.664:2
See TraitObjectTypeSpecification
,
TraitObjectTypeSpecificationOneBound
.
B.665. trait type¶
B.665:1 A trait type is either an impl trait type or a trait object type.
B.666. transparent representation¶
B.666:1 Transparent representation is a type representation that applies only to an enum type with a single enum variant or a struct type where the struct type or enum variant has a single field of non-zero size and any number of fields of size zero and alignment one.
B.667. trivial predicate¶
B.667:1 A trivial predicate is a where clause predicate that does not use the generic parameters or higher-ranked lifetimes of the related construct.
B.668. tuple¶
B.668:1 A tuple is a value of a tuple type.
B.669. tuple enum variant¶
B.669:1
A tuple enum variant is an enum variant with a
TupleStructFieldList
.
B.670. tuple enum variant value¶
B.670:1 A tuple enum variant value is a value of a tuple enum variant.
B.671. tuple expression¶
B.671:1 A tuple expression is an expression that constructs a tuple.
B.671:2
See TupleExpression
.
B.672. tuple field¶
B.672:1 A tuple field is a field of a tuple type.
B.673. tuple initializer¶
B.673:1 A tuple initializer is an operand that provides the value of a tuple field in a tuple expression.
B.674. tuple pattern¶
B.674:1 A tuple pattern is a pattern that matches a tuple which satisfies all criteria defined by its subpatterns.
B.674:2
See TuplePattern
.
B.675. tuple struct¶
B.675:1
A tuple struct is a struct with a TupleStructFieldList
.
B.675:2
See TupleStructDeclaration
.
B.676. tuple struct call expression¶
B.676:1 A tuple struct call expression is a call expression where the call operand resolves to a tuple struct.
B.677. tuple struct field¶
B.677:1 A tuple struct field is a field of a tuple struct type.
B.677:2
See TupleStructField
.
B.678. tuple struct pattern¶
B.678:1 A tuple struct pattern is a pattern that matches a tuple enum variant value or a tuple struct value.
B.678:2
See TupleStructPattern
.
B.679. tuple struct type¶
B.679:1 A tuple struct type is the type of a tuple struct.
B.680. tuple struct value¶
B.680:1 A tuple struct value is a value of a tuple struct type.
B.681. tuple type¶
B.681:1 A tuple type is a sequence type that represents a heterogeneous list of other types.
B.681:2
See TupleTypeSpecification
.
B.682. type¶
B.682:1 A type defines a set of values and a set of operations that act on those values.
B.683. type alias¶
B.683:1 A type alias is an item that defines a name for a type.
B.683:2
See TypeAliasDeclaration
.
B.684. type argument¶
B.684:1 A type argument is a generic argument that supplies the value of a type parameter.
B.684:2
See TypeArgument
.
B.685. type ascription¶
B.685:1 A type ascription specifies the type of a construct.
B.685:2
See TypeAscription
.
B.686. type bound predicate¶
B.686:1 A type bound predicate is a construct that specifies lifetime bounds and trait bounds on a type.
B.686:2
See TypeBoundPredicate
.
B.687. type cast expression¶
B.687:1 A type cast expression is an expression that changes the type of an operand.
B.687:2
See TypeCastExpression
.
B.688. type coercion¶
B.688:1 Type coercion is an implicit operation that changes the type of a value.
B.689. type inference¶
B.689:1 Type inference is the process of deducing the expected type of an arbitrary value.
B.690. type inference root¶
B.690:1 A type inference root is a construct whose inner expressions and patterns are subject to type inference independently of other type inference roots.
B.691. type parameter¶
B.691:1 A type parameter is a generic parameter for a type.
B.691:2
See TypeParameter
.
B.692. type parameter initializer¶
B.692:1 A type parameter initializer is a construct that provides the default value of its related type parameter.
B.692:2
See TypeParameterInitializer
.
B.693. type parameter type¶
B.693:1 A type parameter type is a placeholder type of a type parameter to be substituted by generic substitution.
B.694. type path¶
B.694:1 A type path is a path that acts as a type specification.
B.694:2
See TypePath
.
B.695. type path resolution¶
B.695:1 Type path resolution is a form of path resolution that applies to a type path.
B.696. type representation¶
B.696:1 Type representation specifies the layout of fields of abstract data types.
B.697. type specification¶
B.697:1 A type specification describes the structure of a type.
B.697:2
See TypeSpecification
.
B.698. type unification¶
B.698:1 Type unification is the process by which type inference propagates known types across the type inference root and assigns concrete types to type variables, as well as a general mechanism to check for compatibility between two types during method resolution.
B.699. type variable¶
B.699:1 A type variable is a placeholder used during type inference to stand in for an undetermined type of an expression or a pattern.
B.700. u8¶
B.700:1
u8
is an unsigned integer type whose values range from 0 to
28 - 1, all inclusive.
B.701. u16¶
B.701:1
u16
is an unsigned integer type whose values range from 0 to
216 - 1, all inclusive.
B.702. u32¶
B.702:1
u32
is an unsigned integer type whose values range from 0 to
232 - 1, all inclusive.
B.703. u64¶
B.703:1
u64
is an unsigned integer type whose values range from 0 to
264 - 1, all inclusive.
B.704. u128¶
B.704:1
u128
is an unsigned integer type whose values range from 0 to
2128 - 1, all inclusive.
B.705. unary operator¶
B.705:1 A unary operator operates on one operand.
B.706. undefined behavior¶
B.706:1 Undefined behavior is a situation that results in an unbounded error.
B.707. under resolution¶
B.707:1 A construct that is being resolved is said to be under resolution.
B.708. underscore expression¶
B.708:1 An underscore expression is an expression that acts as a placeholder in a destructuring assignment.
B.708:2
See UnderscoreExpression
.
B.709. underscore pattern¶
B.709:1 An underscore pattern is a pattern that matches any single value.
B.709:2
See UnderscorePattern
.
B.710. unhygienic¶
B.710:1 An identifier is unhygienic when it has call site hygiene.
B.711. Unicode¶
B.711:1 Unicode is the colloquial name for the ISO/IEC 10646:2017 Universal Coded Character Set standard.
B.712. unifiable¶
B.712:1 For unifiable, see unify.
B.713. unifiable types¶
B.713:1 Two types that unify are said to be unifiable types.
B.714. unified type¶
B.714:1 A unified type is a type produced by type unification.
B.715. unify¶
B.715:1 A type is said to unify with another type when the domains, ranges, and structures of both types are compatible.
B.716. union¶
B.716:1 A union is an item that declares a union type.
B.717. union field¶
B.717:1 A union field is a field of a union type.
B.718. union type¶
B.718:1 A union type is an abstract data type similar to a C-like union.
B.718:2
See UnionDeclaration
.
B.719. union value¶
B.719:1 A union value is a value of a union type.
B.720. unique immutable reference¶
B.720:1 A unique immutable reference is an immutable reference produced by capturing what is asserted to be the only live reference to a value while the reference exists.
B.721. unit enum variant¶
B.721:1 A unit enum variant is an enum variant without a field list.
B.722. unit struct¶
B.722:1 A unit struct is a struct without a field list.
B.722:2
See UnitStructDeclaration
.
B.723. unit struct constant¶
B.723:1: A unit struct constant is a constant implicitly created by a unit struct.
B.724. unit struct type¶
B.724:1 A unit struct type is the type of a unit struct.
B.725. unit struct value¶
B.725:1 A unit struct value is a value of a unit struct type.
B.726. unit tuple¶
B.727. unit type¶
B.727:1 The unit type is a tuple type of zero arity.
B.728. unit value¶
B.729. unnamed constant¶
B.729:1 An unnamed constant is a constant declared with character 0x5F (low line).
B.730. unnamed lifetime¶
B.730:1 An unnamed lifetime is a lifetime declared with character 0x5F (low line).
B.731. unqualified path expression¶
B.731:1 An unqualified path expression is a path expression without a qualified type.
B.732. unsafe block¶
B.732:1 For unsafe block, see unsafe block expression.
B.733. unsafe block expression¶
B.733:1
An unsafe block expression is a block expression that is specified
with keyword unsafe
.
B.733:2
See UnsafeBlockExpression
.
B.734. unsafe context¶
B.734:1 An unsafe context is either an unsafe block or an unsafe function.
B.735. unsafe function¶
B.735:1
An unsafe function is a function subject to keyword unsafe
.
B.736. unsafe function item type¶
B.736:1 An unsafe function item type is a function item type where the related function is an unsafe function.
B.737. unsafe function pointer type¶
B.737:1
An unsafe function pointer type is a function pointer type subject to
keyword unsafe
.
B.738. unsafe operation¶
B.738:1 An unsafe operation is an operation that may result in undefined behavior that is not diagnosed as a static error. Unsafe operations are referred to as unsafe Rust.
B.739. unsafe Rust¶
B.739:1 For unsafe Rust, see unsafe operations.
B.740. unsafe trait¶
B.740:1
An unsafe trait is a trait subject to keyword unsafe
B.741. unsafe trait implementation¶
B.741:1
An unsafe trait implementation is a trait implementation subject to
keyword unsafe
.
B.742. unsafety¶
B.742:1 Unsafety is the presence of unsafe operations in program text.
B.743. unsigned integer type¶
B.743:1 An unsigned integer type is an integer type whose values denote zero and positive whole numbers.
B.744. unsized coercion¶
B.744:1 An unsized coercion is a type coercion that converts a sized type into an unsized type.
B.745. unsized type¶
B.745:1 An unsized type is a type with statically unknown size.
B.746. unsuffixed float¶
B.746:1 An unsuffixed float is a float literal without a float suffix.
B.747. unsuffixed integer¶
B.747:1 An unsuffixed integer is an integer literal without an integer suffix.
B.748. use import¶
B.748:1 A use import brings entities in scope within the block expression of an expression-with-block or module where the use import resides.
B.748:2
See UseImport
.
B.749. usize¶
B.749:1
usize
is an unsigned integer type with the same number of bits as
the platform’s pointer type, and is at least 16-bits wide.
B.750. validity invariant¶
B.750:1 A validity invariant is an invariant that when violated results in immediate undefined behavior.
B.751. value¶
B.751:1 A value is either a literal or the result of a computation, that may be stored in a memory location, and interpreted based on some type.
B.752. value expression¶
B.752:1 A value expression is an expression that represents a value.
B.753. value expression context¶
B.753:1 A value expression context is an expression context that is not a place expression context.
B.754. value operand¶
B.754:1 A value operand is an operand that supplies the value that is assigned to an assignee operand by an assignment expression.
B.754:2
See ValueOperand
.
B.755. variable¶
B.755:1 A variable is a placeholder for a value that is allocated on the stack.
B.756. variadic part¶
B.756:1 A variadic part indicates the presence of C-like optional parameters.
B.756:2
See VariadicPart
.
B.757. variance¶
B.757:1 Variance is a property of lifetime parameters and type parameters that describes the circumstances under which a generic type is a subtype of an instantiation of itself with different generic arguments.
B.758. visibility¶
B.758:1 Visibility is a property of fields and items that determines which modules can refer to the name of the field or item.
B.759. visibility modifier¶
B.759:1 A visibility modifier sets the visibility of the name of an item.
B.760. weak keyword¶
B.760:1 A weak keyword is a keyword whose special meaning depends on the context.
B.760:2
See WeakKeyword
.
B.761. where clause¶
B.761:1 A where clause is a construct that specifies bounds on lifetime parameters and type parameters.
B.761:2
See WhereClause
.
B.762. where clause predicate¶
B.762:1 A where clause predicate is either a lifetime bound predicate or a type bound predicate.
B.762:2
See WhereClausePredicate
.
B.763. while let loop¶
B.763:1 For while let loop, see while let loop expression.
B.764. while let loop expression¶
B.764:1 A while let loop expression is a loop expression that continues to evaluate its loop body as long as its subject let expression yields a value that can be matched against its pattern.
B.764:2
See WhileLetLoopExpression
.
B.765. while loop¶
B.765:1 For while loop, see while loop expression.
B.766. while loop expression¶
B.766:1 A while loop expression is a loop expression that continues to evaluate its loop body as long as its iteration expression holds true.
B.766:2
See WhileLoopExpression
.
B.767. whitespace string¶
B.767:1 A whitespace string is a string that consists of one or more whitespace characters.
B.768. zero-sized type¶
B.768:1 A zero-sized type is a fixed sized type with size zero.
B.769. zero-variant enum type¶
B.769:1 A zero-variant enum type is an enum type without any enum variants.