DictionaryElementSyntax
An element inside a dictionary literal.
struct DictionaryElementSyntax
An element inside a dictionary literal.
struct DictionaryElementSyntax
import SwiftSyntax
A library for working with Swift code.
struct ExprSyntax
struct DictionaryElementListSyntax
struct SyntaxChildren
Collection that contains the present child Syntax
nodes of the given node.
struct SyntaxChildrenIndex
An index in a syntax children collection.
struct AccessorDeclListSyntax
struct ArrayElementListSyntax
struct ArrayElementSyntax
An element inside an array literal.
struct AttributeListSyntax
A list of attributes that can be attached to a declaration.
struct AttributeSyntax
An @
attribute.
struct AvailabilityArgumentListSyntax
struct AvailabilityArgumentSyntax
A single argument to an @available
argument like *
, iOS 10.1
, or message: "This has been deprecated"
.
struct CatchClauseListSyntax
struct CatchClauseSyntax
struct CatchItemListSyntax
struct CatchItemSyntax
struct ClosureCaptureListSyntax
struct ClosureCaptureSyntax
struct ClosureParameterListSyntax
struct ClosureParameterSyntax
struct ClosureShorthandParameterListSyntax
A list of closure parameters that are not parenthesized and don’t have type annotations.
struct ClosureShorthandParameterSyntax
struct CodeBlockItemListSyntax
struct CodeBlockItemSyntax
A CodeBlockItem is any Syntax node that appears on its own line inside a CodeBlock.
struct CompositionTypeElementListSyntax
struct CompositionTypeElementSyntax
struct ConditionElementListSyntax
struct ConditionElementSyntax
struct DeclModifierListSyntax
struct DeclModifierSyntax
struct DeclNameArgumentListSyntax
struct DeclNameArgumentSyntax
struct DesignatedTypeListSyntax
struct DesignatedTypeSyntax
struct DifferentiabilityArgumentListSyntax
struct DifferentiabilityArgumentSyntax
A differentiability argument: either the “self” identifier, a function parameter name, or a function parameter index.
struct DocumentationAttributeArgumentListSyntax
The arguments of the ‘@_documentation’ attribute
struct DocumentationAttributeArgumentSyntax
struct EffectsAttributeArgumentListSyntax
The arguments of the ‘@_effects’ attribute. These will be parsed during the SIL stage.
struct EnumCaseElementListSyntax
A collection of 0 or more EnumCaseElementSyntax
s.
struct EnumCaseElementSyntax
An element of an enum case, containing the name of the case and, optionally, either associated values or an assignment to a raw value.
struct EnumCaseParameterListSyntax
struct EnumCaseParameterSyntax
struct ExprListSyntax
A list of expressions connected by operators. This list is contained by a SequenceExprSyntax
.
struct FunctionParameterListSyntax
struct FunctionParameterSyntax
struct GenericArgumentListSyntax
struct GenericArgumentSyntax
struct GenericParameterListSyntax
struct GenericParameterSyntax
struct GenericRequirementListSyntax
struct GenericRequirementSyntax
struct IfConfigClauseListSyntax
struct IfConfigClauseSyntax
struct ImportPathComponentListSyntax
struct ImportPathComponentSyntax
struct InheritedTypeListSyntax
struct InheritedTypeSyntax
struct KeyPathComponentListSyntax
The components of a key path
struct KeyPathComponentSyntax
A single key path component
struct LabeledExprListSyntax
struct LabeledExprSyntax
An expression that is prefixed by a label.
struct MemberBlockItemListSyntax
struct MemberBlockItemSyntax
A member declaration of a type consisting of a declaration and an optional semicolon;
struct MultipleTrailingClosureElementListSyntax
struct MultipleTrailingClosureElementSyntax
struct ObjCSelectorPieceListSyntax
struct ObjCSelectorPieceSyntax
A piece of an Objective-C selector. Either consisting of just an identifier for a nullary selector, an identifier and a colon for a labeled argument or just a colon for an unlabeled argument
struct PatternBindingListSyntax
struct PatternBindingSyntax
Defines variables inside a variable declaration.
struct PlatformVersionItemListSyntax
struct PlatformVersionItemSyntax
A single platform/version pair in an attribute, e.g. iOS 10.1
.
struct PrecedenceGroupAttributeListSyntax
struct PrecedenceGroupRelationSyntax
Specify the new precedence group’s relation to existing precedence groups.
struct PrecedenceGroupAssignmentSyntax
Specifies the precedence of an operator when used in an operation that includes optional chaining.
struct PrecedenceGroupAssociativitySyntax
Specifies how a sequence of operators with the same precedence level are grouped together in the absence of grouping parentheses.
struct PrecedenceGroupNameListSyntax
struct PrecedenceGroupNameSyntax
struct PrimaryAssociatedTypeListSyntax
struct PrimaryAssociatedTypeSyntax
struct SimpleStringLiteralSegmentListSyntax
String literal segments that only can contain non string interpolated or extended escaped strings
struct StringSegmentSyntax
A literal segment inside a string segment.
struct SpecializeAttributeArgumentListSyntax
A collection of arguments for the @_specialize
attribute
struct LabeledSpecializeArgumentSyntax
A labeled argument for the @_specialize
attribute like exported: true
struct SpecializeAvailabilityArgumentSyntax
The availability argument for the _specialize attribute
struct SpecializeTargetFunctionArgumentSyntax
A labeled argument for the @_specialize
attribute with a function decl value like target: myFunc(_:)
struct GenericWhereClauseSyntax
A where
clause that places additional constraints on generic parameters like where Element: Hashable
.
struct StringLiteralSegmentListSyntax
struct ExpressionSegmentSyntax
An interpolated expression inside a string literal.
struct SwitchCaseItemListSyntax
struct SwitchCaseItemSyntax
struct SwitchCaseListSyntax
struct SwitchCaseSyntax
struct TuplePatternElementListSyntax
A list of TuplePatternElementSyntax
.
struct TuplePatternElementSyntax
An element that represents a single tuple value in TuplePatternElementListSyntax
.
struct TupleTypeElementListSyntax
struct TupleTypeElementSyntax
struct TypeSpecifierListSyntax
struct SimpleTypeSpecifierSyntax
A specifier that can be attached to a type to eg. mark a parameter as inout
or consuming
struct UnexpectedNodesSyntax
A collection of syntax nodes that occurred in the source code but could not be used to form a valid syntax tree.
struct VersionComponentListSyntax
struct VersionComponentSyntax
An element to represent a single component in a version, like .1
.
struct YieldedExpressionListSyntax
struct YieldedExpressionSyntax
protocol Copyable
A type whose values can be implicitly or explicitly copied.
protocol CustomDebugStringConvertible
A type with a customized textual representation suitable for debugging purposes.
protocol CustomReflectable
A type that explicitly supplies its own mirror.
protocol CustomStringConvertible
A type with a customized textual representation.
protocol Equatable
A type that can be compared for value equality.
protocol Escapable
protocol Hashable : Equatable
A type that can be hashed into a Hasher
to produce an integer hash value.
protocol Sendable
protocol SyntaxHashable : Hashable
Protocol that provides a common Hashable implementation for all syntax nodes
protocol SyntaxProtocol : CustomDebugStringConvertible, CustomReflectable, CustomStringConvertible, Sendable, TextOutputStreamable
Provide common functionality for specialized syntax nodes. Extend this protocol to provide common functionality for all syntax nodes.
protocol TextOutputStreamable
A source of text-streaming operations.
protocol WithTrailingCommaSyntax : SyntaxProtocol
protocol _LeafSyntaxNodeProtocol : SyntaxProtocol
Protocol that syntax nodes conform to if they don’t have any semantic subtypes. These are syntax nodes that are not considered base nodes for other syntax types.
init?(_ node: some SyntaxProtocol)
init(leadingTrivia: Trivia? = nil, _ unexpectedBeforeKey: UnexpectedNodesSyntax? = nil, key: some ExprSyntaxProtocol, _ unexpectedBetweenKeyAndColon: UnexpectedNodesSyntax? = nil, colon: TokenSyntax = .colonToken(), _ unexpectedBetweenColonAndValue: UnexpectedNodesSyntax? = nil, value: some ExprSyntaxProtocol, _ unexpectedBetweenValueAndTrailingComma: UnexpectedNodesSyntax? = nil, trailingComma: TokenSyntax? = nil, _ unexpectedAfterTrailingComma: UnexpectedNodesSyntax? = nil, trailingTrivia: Trivia? = nil)
static let structure: SyntaxNodeStructure
let _syntaxNode: Syntax
var colon: TokenSyntax { get set }
var key: ExprSyntax { get set }
var trailingComma: TokenSyntax? { get set }
var unexpectedAfterTrailingComma: UnexpectedNodesSyntax? { get set }
var unexpectedBeforeKey: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenColonAndValue: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenKeyAndColon: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenValueAndTrailingComma: UnexpectedNodesSyntax? { get set }
var value: ExprSyntax { get set }
init(leadingTrivia: Trivia? = nil, _ unexpectedBeforeKeyExpression: UnexpectedNodesSyntax? = nil, keyExpression: some ExprSyntaxProtocol, _ unexpectedBetweenKeyExpressionAndColon: UnexpectedNodesSyntax? = nil, colon: TokenSyntax = .colonToken(), _ unexpectedBetweenColonAndValueExpression: UnexpectedNodesSyntax? = nil, valueExpression: some ExprSyntaxProtocol, _ unexpectedBetweenValueExpressionAndTrailingComma: UnexpectedNodesSyntax? = nil, trailingComma: TokenSyntax? = nil, _ unexpectedAfterTrailingComma: UnexpectedNodesSyntax? = nil, trailingTrivia: Trivia? = nil)
var keyExpression: ExprSyntax { get set }
var unexpectedBeforeKeyExpression: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenColonAndValueExpression: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenKeyExpressionAndColon: UnexpectedNodesSyntax? { get set }
var unexpectedBetweenValueExpressionAndTrailingComma: UnexpectedNodesSyntax? { get set }
var valueExpression: ExprSyntax { get set }
init?<S>(_ node: S?) where S : SyntaxProtocol
Initializes a new instance of the conforming type from a given specialized syntax node.
var customMirror: Mirror { get }
var debugDescription: String { get }
A simple description of this node (ie. its type).
var description: String { get }
A source-accurate description of this node.
var detached: Self { get }
Return this subtree with this node as the root, ie. detach this node from its parent.
var endPosition: AbsolutePosition { get }
The end position of this node, including its trivia.
var endPositionBeforeTrailingTrivia: AbsolutePosition { get }
The end position of this node’s content, before any trailing trivia.
var hasError: Bool { get }
Whether the tree contained by this layout has any
var hasMaximumNestingLevelOverflow: Bool { get }
var hasParent: Bool { get }
Whether or not this node has a parent.
var hasSequenceExpr: Bool { get }
Whether this tree contains a missing token or unexpected node.
var hasWarning: Bool { get }
Whether the tree contained by this layout has any tokens with a TokenDiagnostic
of severity warning
.
var id: SyntaxIdentifier { get }
Returns a value representing the unique identity of the node.
var keyPathInParent: AnyKeyPath? { get }
var kind: SyntaxKind { get }
The kind of the syntax node, e.g. if it is a functionDecl
.
var leadingTrivia: Trivia { get set }
The leading trivia of this syntax node.
var leadingTriviaLength: SourceLength { get }
The length this node’s leading trivia takes up spelled out in source.
var parent: Syntax? { get }
The parent of this syntax node, or nil
if this node is the root.
var position: AbsolutePosition { get }
The absolute position of the starting point of this node. If the first token is with leading trivia, the position points to the start of the leading trivia.
var positionAfterSkippingLeadingTrivia: AbsolutePosition { get }
The absolute position of the starting point of this node, skipping any leading trivia attached to the first token syntax.
var raw: RawSyntax { get }
var root: Syntax { get }
The root of the tree in which this node resides.
var syntaxNodeType: SyntaxProtocol.Type { get }
The dynamic metatype of the concrete node.
var syntaxTextBytes: [UInt8] { get }
Retrieve the syntax text as an array of bytes that models the input source even in the presence of invalid UTF-8.
var totalByteRange: ByteSourceRange { get }
The byte source range of this node including leading and trailing trivia.
var totalLength: SourceLength { get }
The length of this node including all of its trivia.
var trailingTrivia: Trivia { get set }
The trailing trivia of this syntax node.
var trailingTriviaLength: SourceLength { get }
The length this node’s trailing trivia takes up spelled out in source.
var trimmed: Self { get }
A copy of this node without the leading trivia of the first token in the node and the trailing trivia of the last token in the node.
var trimmedByteRange: ByteSourceRange { get }
The byte source range of this node excluding leading and trailing trivia.
var trimmedDescription: String { get }
The description of this node with leading whitespace of the first token and trailing whitespace of the last token removed.
var trimmedLength: SourceLength { get }
The length this node takes up spelled out in the source, excluding its leading or trailing trivia.
static func != (lhs: Self, rhs: Self) -> Bool
Returns a Boolean value indicating whether two values are not equal.
static func == (lhs: Self, rhs: Self) -> Bool
func `as`<S>(_ syntaxType: S.Type) -> S? where S : SyntaxProtocol
Attempts to cast the current syntax node to a given specialized syntax type.
func asProtocol(_: MissingNodeSyntax.Protocol) -> MissingNodeSyntax?
Return the non-type erased version of this syntax node if it conforms to MissingNodeSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: ParenthesizedSyntax.Protocol) -> ParenthesizedSyntax?
Return the non-type erased version of this syntax node if it conforms to ParenthesizedSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithCodeBlockSyntax.Protocol) -> WithCodeBlockSyntax?
Return the non-type erased version of this syntax node if it conforms to WithCodeBlockSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithModifiersSyntax.Protocol) -> WithModifiersSyntax?
Return the non-type erased version of this syntax node if it conforms to WithModifiersSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithAttributesSyntax.Protocol) -> WithAttributesSyntax?
Return the non-type erased version of this syntax node if it conforms to WithAttributesSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithStatementsSyntax.Protocol) -> WithStatementsSyntax?
Return the non-type erased version of this syntax node if it conforms to WithStatementsSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: EffectSpecifiersSyntax.Protocol) -> EffectSpecifiersSyntax?
Return the non-type erased version of this syntax node if it conforms to EffectSpecifiersSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithTrailingCommaSyntax.Protocol) -> WithTrailingCommaSyntax?
Return the non-type erased version of this syntax node if it conforms to WithTrailingCommaSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithGenericParametersSyntax.Protocol) -> WithGenericParametersSyntax?
Return the non-type erased version of this syntax node if it conforms to WithGenericParametersSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: WithOptionalCodeBlockSyntax.Protocol) -> WithOptionalCodeBlockSyntax?
Return the non-type erased version of this syntax node if it conforms to WithOptionalCodeBlockSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: FreestandingMacroExpansionSyntax.Protocol) -> FreestandingMacroExpansionSyntax?
Return the non-type erased version of this syntax node if it conforms to FreestandingMacroExpansionSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: BracedSyntax.Protocol) -> BracedSyntax?
Return the non-type erased version of this syntax node if it conforms to BracedSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: DeclGroupSyntax.Protocol) -> DeclGroupSyntax?
Return the non-type erased version of this syntax node if it conforms to DeclGroupSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func asProtocol(_: NamedDeclSyntax.Protocol) -> NamedDeclSyntax?
Return the non-type erased version of this syntax node if it conforms to NamedDeclSyntax
. Otherwise return nil
. Note that this will incur an existential conversion.
func cast<S>(_ syntaxType: S.Type) -> S where S : SyntaxProtocol
Force-casts the current syntax node to a given specialized syntax type.
func children(viewMode: SyntaxTreeViewMode) -> SyntaxChildren
A sequence over the children of this node.
func debugDescription(includeTrivia: Bool = false, converter: SourceLocationConverter? = nil, mark: SyntaxProtocol? = nil, indentString: String = "") -> String
Returns a summarized dump of this node.
func endLocation(converter: SourceLocationConverter, afterTrailingTrivia: Bool = false) -> SourceLocation
The ending location, in the provided file, of this Syntax node.
func firstToken(viewMode: SyntaxTreeViewMode) -> TokenSyntax?
Returns the first token node that is part of this syntax node.
func hash(into hasher: inout Hasher)
func `is`<S>(_ syntaxType: S.Type) -> Bool where S : SyntaxProtocol
Checks if the current syntax node can be cast to a given specialized syntax type.
func isProtocol(_: MissingNodeSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to MissingNodeSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: ParenthesizedSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to ParenthesizedSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithCodeBlockSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithCodeBlockSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithModifiersSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithModifiersSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithAttributesSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithAttributesSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithStatementsSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithStatementsSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: EffectSpecifiersSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to EffectSpecifiersSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithTrailingCommaSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithTrailingCommaSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithGenericParametersSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithGenericParametersSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: WithOptionalCodeBlockSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to WithOptionalCodeBlockSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: FreestandingMacroExpansionSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to FreestandingMacroExpansionSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: BracedSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to BracedSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: DeclGroupSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to DeclGroupSyntax
. Note that this will incur an existential conversion.
func isProtocol(_: NamedDeclSyntax.Protocol) -> Bool
Check whether the non-type erased version of this syntax node conforms to NamedDeclSyntax
. Note that this will incur an existential conversion.
func lastToken(viewMode: SyntaxTreeViewMode) -> TokenSyntax?
Returns the last token node that is part of this syntax node.
func nextToken(viewMode: SyntaxTreeViewMode) -> TokenSyntax?
Recursively walks through the tree to find the next token semantically after this node.
func node(at syntaxIdentifier: SyntaxIdentifier) -> Syntax?
If the node with the given syntaxIdentifier
is a (recursive) child of this node, return the node with that identifier.
func previousToken(viewMode: SyntaxTreeViewMode) -> TokenSyntax?
Recursively walks through the tree to find the token semantically before this node.
func sourceRange(converter: SourceLocationConverter, afterLeadingTrivia: Bool = true, afterTrailingTrivia: Bool = false) -> SourceRange
The source range, in the provided file, of this Syntax node.
func startLocation(converter: SourceLocationConverter, afterLeadingTrivia: Bool = true) -> SourceLocation
The starting location, in the provided file, of this Syntax node.
func token(at position: AbsolutePosition) -> TokenSyntax?
Find the syntax token at the given absolute position within this syntax node or any of its children.
func tokens(viewMode: SyntaxTreeViewMode) -> TokenSequence
Sequence of tokens that are part of this Syntax node.
func trimmed(matching filter: (TriviaPiece) -> Bool) -> Self
A copy of this node with pieces that match matching
trimmed from the leading trivia of the first token and trailing trivia of the last token.
func trimmedDescription(matching filter: (TriviaPiece) -> Bool) -> String
The description of this node with pieces that match matching
removed from the leading trivia of the first token and trailing trivia of the last token.
func with<T>(_ keyPath: WritableKeyPath<WithTrailingCommaSyntax, T>, _ newChild: T) -> WithTrailingCommaSyntax
Without this function, the with
function defined on SyntaxProtocol
does not work on existentials of this protocol type.
func with<T>(_ keyPath: WritableKeyPath<Self, T>, _ value: T) -> Self
Returns a new syntax node that has the child at keyPath
replaced by value
.
func write<Target>(to target: inout Target) where Target : TextOutputStream
Prints the raw value of this node to the provided stream.
var byteRange: ByteSourceRange { get }
var byteSize: Int { get }
The textual byte length of this node including leading and trailing trivia.
var byteSizeAfterTrimmingTrivia: Int { get }
The textual byte length of this node excluding leading and trailing trivia.
var contentLength: SourceLength { get }
var firstToken: TokenSyntax? { get }
var index: SyntaxChildrenIndex { get }
The index of this node in a SyntaxChildren
collection.
var isImplicit: Bool { get }
When isImplicit is true, the syntax node doesn’t include any underlying tokens, e.g. an empty CodeBlockItemList.
var lastToken: TokenSyntax? { get }
var nextToken: TokenSyntax? { get }
var previousToken: TokenSyntax? { get }
func `as`<S>(_ syntaxType: S.Type) -> S? where S : SyntaxProtocol
Attempts to cast the current leaf syntax node to a different specified type.
func `as`(_ syntaxType: Syntax.Type) -> Syntax?
Attempts to upcast the current syntax node to Syntax
node.
func `as`(_ syntaxType: Self.Type) -> Self?
Casts the current syntax node to its own type.
func cast<S>(_ syntaxType: S.Type) -> S where S : SyntaxProtocol
Force-casts the current leaf syntax node to a different specified type.
func cast(_ syntaxType: Syntax.Type) -> Syntax
Force-cast the current syntax node to Syntax
node..
func cast(_ syntaxType: Self.Type) -> Self
Force-casts the current syntax node to its own type.
func detach() -> Self
func `is`<S>(_ syntaxType: S.Type) -> Bool where S : SyntaxProtocol
Checks if the current leaf syntax node can be cast to a different specified type.
func `is`(_ syntaxType: Syntax.Type) -> Bool
Checks if the current syntax node can be upcast to Syntax
node.
func `is`(_ syntaxType: Self.Type) -> Bool
Checks if the current syntax node can be cast to its own type.