Lexical Structure
Use the lowest-level components of the syntax.
The lexical structure of Swift describes what sequence of characters form valid tokens of the language. These valid tokens form the lowest-level building blocks of the language and are used to describe the rest of the language in subsequent chapters. A token consists of an identifier, keyword, punctuation, literal, or operator.
In most cases, tokens are generated from the characters of a Swift source file by considering the longest possible substring from the input text, within the constraints of the grammar that are specified below. This behavior is referred to as longest match or maximal munch.
Whitespace and Comments
Whitespace has two uses: to separate tokens in the source file and to distinguish between prefix, postfix, and infix operators (see LexicalStructure#Operators), but is otherwise ignored. The following characters are considered whitespace: space (U+0020), line feed (U+000A), carriage return (U+000D), horizontal tab (U+0009), vertical tab (U+000B), form feed (U+000C) and null (U+0000).
Comments are treated as whitespace by the compiler.
Single line comments begin with //
and continue until a line feed (U+000A) or carriage return (U+000D).
Multiline comments begin with /*
and end with */
.
Nesting multiline comments is allowed,
but the comment markers must be balanced.
Comments can contain additional formatting and markup, as described in Markup Formatting Reference (opens in a new tab).
Grammar of whitespace:
whitespace → whitespace-item whitespace?
whitespace-item → line-break
whitespace-item → inline-space
whitespace-item → comment
whitespace-item → multiline-comment
whitespace-item → U+0000, U+000B, or U+000Cline-break → U+000A
line-break → U+000D
line-break → U+000D followed by U+000Ainline-spaces → inline-space inline-spaces?
inline-space → U+0009 or U+0020comment →
//
comment-text line-break
multiline-comment →/*
multiline-comment-text*/
comment-text → comment-text-item comment-text?
comment-text-item → Any Unicode scalar value except U+000A or U+000Dmultiline-comment-text → multiline-comment-text-item multiline-comment-text?
multiline-comment-text-item → multiline-comment
multiline-comment-text-item → comment-text-item
multiline-comment-text-item → Any Unicode scalar value except/*
or*/
Identifiers
Identifiers begin with
an uppercase or lowercase letter A through Z,
an underscore (_
),
a noncombining alphanumeric Unicode character
in the Basic Multilingual Plane,
or a character outside the Basic Multilingual Plane
that isn't in a Private Use Area.
After the first character,
digits and combining Unicode characters are also allowed.
Treat identifiers that begin with an underscore,
subscripts whose first argument label begins with an underscore,
and initializers whose first argument label begins with an underscore,
as internal,
even if their declaration has the public
access-level modifier.
This convention lets framework authors mark part of an API
that clients must not interact with or depend on,
even though some limitation requires the declaration to be public.
In addition,
identifiers that begin with two underscores
are reserved for the Swift compiler and standard library.
To use a reserved word as an identifier,
put a backtick (`) before and after it.
For example, class
isn't a valid identifier,
but `class`
is valid.
The backticks aren't considered part of the identifier;
`x`
and x
have the same meaning.
Inside a closure with no explicit parameter names,
the parameters are implicitly named $0
, $1
, $2
, and so on.
These names are valid identifiers within the scope of the closure.
The compiler synthesizes identifiers that begin with a dollar sign ($
)
for properties that have a property wrapper projection.
Your code can interact with these identifiers,
but you can't declare identifiers with that prefix.
For more information, see the Attributes#propertyWrapper section
of the Attributes chapter.
Grammar of an identifier:
identifier → identifier-head identifier-characters?
identifier →`
identifier-head identifier-characters?`
identifier → implicit-parameter-name
identifier → property-wrapper-projection
identifier-list → identifier | identifier,
identifier-listidentifier-head → Upper- or lowercase letter A through Z
identifier-head →_
identifier-head → U+00A8, U+00AA, U+00AD, U+00AF, U+00B2–U+00B5, or U+00B7–U+00BA
identifier-head → U+00BC–U+00BE, U+00C0–U+00D6, U+00D8–U+00F6, or U+00F8–U+00FF
identifier-head → U+0100–U+02FF, U+0370–U+167F, U+1681–U+180D, or U+180F–U+1DBF
identifier-head → U+1E00–U+1FFF
identifier-head → U+200B–U+200D, U+202A–U+202E, U+203F–U+2040, U+2054, or U+2060–U+206F
identifier-head → U+2070–U+20CF, U+2100–U+218F, U+2460–U+24FF, or U+2776–U+2793
identifier-head → U+2C00–U+2DFF or U+2E80–U+2FFF
identifier-head → U+3004–U+3007, U+3021–U+302F, U+3031–U+303F, or U+3040–U+D7FF
identifier-head → U+F900–U+FD3D, U+FD40–U+FDCF, U+FDF0–U+FE1F, or U+FE30–U+FE44
identifier-head → U+FE47–U+FFFD
identifier-head → U+10000–U+1FFFD, U+20000–U+2FFFD, U+30000–U+3FFFD, or U+40000–U+4FFFD
identifier-head → U+50000–U+5FFFD, U+60000–U+6FFFD, U+70000–U+7FFFD, or U+80000–U+8FFFD
identifier-head → U+90000–U+9FFFD, U+A0000–U+AFFFD, U+B0000–U+BFFFD, or U+C0000–U+CFFFD
identifier-head → U+D0000–U+DFFFD or U+E0000–U+EFFFDidentifier-character → Digit 0 through 9
identifier-character → U+0300–U+036F, U+1DC0–U+1DFF, U+20D0–U+20FF, or U+FE20–U+FE2F
identifier-character → identifier-head
identifier-characters → identifier-character identifier-characters?implicit-parameter-name →
$
decimal-digits
property-wrapper-projection →$
identifier-characters
Keywords and Punctuation
The following keywords are reserved and can't be used as identifiers,
unless they're escaped with backticks,
as described above in LexicalStructure#Identifiers.
Keywords other than inout
, var
, and let
can be used as parameter names
in a function declaration or function call
without being escaped with backticks.
When a member has the same name as a keyword,
references to that member don't need to be escaped with backticks,
except when there's ambiguity between referring to the member
and using the keyword ---
for example, self
, Type
, and Protocol
have special meaning in an explicit member expression,
so they must be escaped with backticks in that context.
- Keywords used in declarations:
associatedtype
,class
,deinit
,enum
,extension
,fileprivate
,func
,import
,init
,inout
,internal
,let
,open
,operator
,private
,precedencegroup
,protocol
,public
,rethrows
,static
,struct
,subscript
,typealias
, andvar
.
- Keywords used in statements:
break
,case
,catch
,continue
,default
,defer
,do
,else
,fallthrough
,for
,guard
,if
,in
,repeat
,return
,throw
,switch
,where
, andwhile
. - Keywords used in expressions and types:
Any
,as
,await
,catch
,false
,is
,nil
,rethrows
,self
,Self
,super
,throw
,throws
,true
, andtry
. - Keywords used in patterns:
_
. - Keywords that begin with a number sign (
#
):#available
,#colorLiteral
,#elseif
,#else
,#endif
,#fileLiteral
,#if
,#imageLiteral
,#keyPath
,#selector
,#sourceLocation
.
Note: Prior to Swift 5.9, the following keywords were reserved:
#column
,#dsohandle
,#error
,#fileID
,#filePath
,#file
,#function
,#line
, and#warning
. These are now implemented as macros in the Swift standard library:column
(opens in a new tab),dsohandle
(opens in a new tab),error(_:)
(opens in a new tab),fileID
(opens in a new tab),filePath
(opens in a new tab),file
(opens in a new tab),function
(opens in a new tab),line
(opens in a new tab), andwarning(_:)
(opens in a new tab).
- Keywords reserved in particular contexts:
associativity
,convenience
,didSet
,dynamic
,final
,get
,indirect
,infix
,lazy
,left
,mutating
,none
,nonmutating
,optional
,override
,postfix
,precedence
,prefix
,Protocol
,required
,right
,set
,some
,Type
,unowned
,weak
, andwillSet
. Outside the context in which they appear in the grammar, they can be used as identifiers.
The following tokens are reserved as punctuation
and can't be used as custom operators:
(
, )
, {
, }
, [
, ]
,
.
, ,
, :
, ;
, =
, @
, #
,
&
(as a prefix operator), ->
, `
,
?
, and !
(as a postfix operator).
Literals
A literal is the source code representation of a value of a type, such as a number or string.
The following are examples of literals:
42 // Integer literal
3.14159 // Floating-point literal
"Hello, world!" // String literal
/Hello, .*/ // Regular expression literal
true // Boolean literal
A literal doesn't have a type on its own.
Instead, a literal is parsed as having infinite precision and Swift's type inference
attempts to infer a type for the literal. For example,
in the declaration let x: Int8 = 42
,
Swift uses the explicit type annotation (: Int8
) to infer
that the type of the integer literal 42
is Int8
.
If there isn't suitable type information available,
Swift infers that the literal's type is one of the default literal types
defined in the Swift standard library
and listed in the table below.
When specifying the type annotation for a literal value,
the annotation's type must be a type that can be instantiated from that literal value.
That is, the type must conform to the Swift standard library protocols
listed in the table below.
Literal | Default type | Protocol |
---|---|---|
Integer | Int | ExpressibleByIntegerLiteral |
Floating-point | Double | ExpressibleByFloatLiteral |
String | String | ExpressibleByStringLiteral , ExpressibleByUnicodeScalarLiteral for string literals that contain only a single Unicode scalar, ExpressibleByExtendedGraphemeClusterLiteral for string literals that contain only a single extended grapheme cluster |
Regular expression | Regex | None |
Boolean | Bool | ExpressibleByBooleanLiteral |
For example, in the declaration let str = "Hello, world"
,
the default inferred type of the string
literal "Hello, world"
is String
.
Also, Int8
conforms to the ExpressibleByIntegerLiteral
protocol,
and therefore it can be used in the type annotation for the integer literal 42
in the declaration let x: Int8 = 42
.
Grammar of a literal:
literal → numeric-literal | string-literal | regular-expression-literal | boolean-literal | nil-literal
numeric-literal →
-
? integer-literal |-
? floating-point-literal
boolean-literal →true
|false
nil-literal →nil
Integer Literals
Integer literals represent integer values of unspecified precision.
By default, integer literals are expressed in decimal;
you can specify an alternate base using a prefix.
Binary literals begin with 0b
,
octal literals begin with 0o
,
and hexadecimal literals begin with 0x
.
Decimal literals contain the digits 0
through 9
.
Binary literals contain 0
and 1
,
octal literals contain 0
through 7
,
and hexadecimal literals contain 0
through 9
as well as A
through F
in upper- or lowercase.
Negative integers literals are expressed by prepending a minus sign (-
)
to an integer literal, as in -42
.
Underscores (_
) are allowed between digits for readability,
but they're ignored and therefore don't affect the value of the literal.
Integer literals can begin with leading zeros (0
),
but they're likewise ignored and don't affect the base or value of the literal.
Unless otherwise specified,
the default inferred type of an integer literal is the Swift standard library type Int
.
The Swift standard library also defines types for various sizes of
signed and unsigned integers,
as described in TheBasics#Integers.
Grammar of an integer literal:
integer-literal → binary-literal
integer-literal → octal-literal
integer-literal → decimal-literal
integer-literal → hexadecimal-literalbinary-literal →
0b
binary-digit binary-literal-characters?
binary-digit → Digit 0 or 1
binary-literal-character → binary-digit |_
binary-literal-characters → binary-literal-character binary-literal-characters?octal-literal →
0o
octal-digit octal-literal-characters?
octal-digit → Digit 0 through 7
octal-literal-character → octal-digit |_
octal-literal-characters → octal-literal-character octal-literal-characters?decimal-literal → decimal-digit decimal-literal-characters?
decimal-digit → Digit 0 through 9
decimal-digits → decimal-digit decimal-digits?
decimal-literal-character → decimal-digit |_
decimal-literal-characters → decimal-literal-character decimal-literal-characters?hexadecimal-literal →
0x
hexadecimal-digit hexadecimal-literal-characters?
hexadecimal-digit → Digit 0 through 9, a through f, or A through F
hexadecimal-literal-character → hexadecimal-digit |_
hexadecimal-literal-characters → hexadecimal-literal-character hexadecimal-literal-characters?
Floating-Point Literals
Floating-point literals represent floating-point values of unspecified precision.
By default, floating-point literals are expressed in decimal (with no prefix),
but they can also be expressed in hexadecimal (with a 0x
prefix).
Decimal floating-point literals consist of a sequence of decimal digits
followed by either a decimal fraction, a decimal exponent, or both.
The decimal fraction consists of a decimal point (.
)
followed by a sequence of decimal digits.
The exponent consists of an upper- or lowercase e
prefix
followed by a sequence of decimal digits that indicates
what power of 10 the value preceding the e
is multiplied by.
For example, 1.25e2
represents 1.25 x 10²,
which evaluates to 125.0
.
Similarly, 1.25e-2
represents 1.25 x 10⁻²,
which evaluates to 0.0125
.
Hexadecimal floating-point literals consist of a 0x
prefix,
followed by an optional hexadecimal fraction,
followed by a hexadecimal exponent.
The hexadecimal fraction consists of a decimal point
followed by a sequence of hexadecimal digits.
The exponent consists of an upper- or lowercase p
prefix
followed by a sequence of decimal digits that indicates
what power of 2 the value preceding the p
is multiplied by.
For example, 0xFp2
represents 15 x 2²,
which evaluates to 60
.
Similarly, 0xFp-2
represents 15 x 2⁻²,
which evaluates to 3.75
.
Negative floating-point literals are expressed by prepending a minus sign (-
)
to a floating-point literal, as in -42.5
.
Underscores (_
) are allowed between digits for readability,
but they're ignored and therefore don't affect the value of the literal.
Floating-point literals can begin with leading zeros (0
),
but they're likewise ignored and don't affect the base or value of the literal.
Unless otherwise specified,
the default inferred type of a floating-point literal is the Swift standard library type Double
,
which represents a 64-bit floating-point number.
The Swift standard library also defines a Float
type,
which represents a 32-bit floating-point number.
Grammar of a floating-point literal:
floating-point-literal → decimal-literal decimal-fraction? decimal-exponent?
floating-point-literal → hexadecimal-literal hexadecimal-fraction? hexadecimal-exponentdecimal-fraction →
.
decimal-literal
decimal-exponent → floating-point-e sign? decimal-literalhexadecimal-fraction →
.
hexadecimal-digit hexadecimal-literal-characters?
hexadecimal-exponent → floating-point-p sign? decimal-literalfloating-point-e →
e
|E
floating-point-p →p
|P
sign →+
|-
String Literals
A string literal is a sequence of characters surrounded by quotation marks. A single-line string literal is surrounded by double quotation marks and has the following form:
"<#characters#>"
String literals can't contain
an unescaped double quotation mark ("
),
an unescaped backslash (\
),
a carriage return, or a line feed.
A multiline string literal is surrounded by three double quotation marks and has the following form:
"""
<#characters#>
"""
Unlike a single-line string literal,
a multiline string literal can contain
unescaped double quotation marks ("
), carriage returns, and line feeds.
It can't contain three unescaped double quotation marks next to each other.
The line break after the """
that begins the multiline string literal
isn't part of the string.
The line break before the """
that ends the literal is also not part of the string.
To make a multiline string literal
that begins or ends with a line feed,
write a blank line as its first or last line.
A multiline string literal can be indented
using any combination of spaces and tabs;
this indentation isn't included in the string.
The """
that ends the literal
determines the indentation:
Every nonblank line in the literal must begin
with exactly the same indentation
that appears before the closing """
;
there's no conversion between tabs and spaces.
You can include additional spaces and tabs after that indentation;
those spaces and tabs appear in the string.
Line breaks in a multiline string literal are normalized to use the line feed character. Even if your source file has a mix of carriage returns and line feeds, all of the line breaks in the string will be the same.
In a multiline string literal,
writing a backslash (\
) at the end of a line
omits that line break from the string.
Any whitespace between the backslash and the line break
is also omitted.
You can use this syntax
to hard wrap a multiline string literal in your source code,
without changing the value of the resulting string.
Special characters can be included in string literals of both the single-line and multiline forms using the following escape sequences:
- Null character (
\0
) - Backslash (
\\
) - Horizontal tab (
\t
) - Line feed (
\n
) - Carriage return (
\r
) - Double quotation mark (
\"
) - Single quotation mark (
\'
) - Unicode scalar (
\u{
n}
), where n is a hexadecimal number that has one to eight digits
The value of an expression can be inserted into a string literal
by placing the expression in parentheses after a backslash (\
).
The interpolated expression can contain a string literal,
but can't contain an unescaped backslash,
a carriage return, or a line feed.
For example, all of the following string literals have the same value:
"1 2 3"
"1 2 \("3")"
"1 2 \(3)"
"1 2 \(1 + 2)"
let x = 3; "1 2 \(x)"
A string delimited by extended delimiters is a sequence of characters
surrounded by quotation marks and a balanced set of one or more number signs (#
).
A string delimited by extended delimiters has the following forms:
#"<#characters#>"#
#"""
<#characters#>
"""#
Special characters in a string delimited by extended delimiters appear in the resulting string as normal characters rather than as special characters. You can use extended delimiters to create strings with characters that would ordinarily have a special effect such as generating a string interpolation, starting an escape sequence, or terminating the string.
The following example shows a string literal and a string delimited by extended delimiters that create equivalent string values:
let string = #"\(x) \ " \u{2603}"#
let escaped = "\\(x) \\ \" \\u{2603}"
print(string)
// Prints "\(x) \ " \u{2603}"
print(string == escaped)
// Prints "true"
If you use more than one number sign to form a string delimited by extended delimiters, don't place whitespace in between the number signs:
print(###"Line 1\###nLine 2"###) // OK
print(# # #"Line 1\# # #nLine 2"# # #) // Error
Multiline string literals that you create using extended delimiters have the same indentation requirements as regular multiline string literals.
The default inferred type of a string literal is String
.
For more information about the String
type,
see Strings and Characters
and String
(opens in a new tab).
String literals that are concatenated by the +
operator
are concatenated at compile time.
For example, the values of textA
and textB
in the example below are identical ---
no runtime concatenation is performed.
let textA = "Hello " + "world"
let textB = "Hello world"
Grammar of a string literal:
string-literal → static-string-literal | interpolated-string-literal
string-literal-opening-delimiter → extended-string-literal-delimiter?
"
string-literal-closing-delimiter →"
extended-string-literal-delimiter?static-string-literal → string-literal-opening-delimiter quoted-text? string-literal-closing-delimiter
static-string-literal → multiline-string-literal-opening-delimiter multiline-quoted-text? multiline-string-literal-closing-delimitermultiline-string-literal-opening-delimiter → extended-string-literal-delimiter?
"""
multiline-string-literal-closing-delimiter →"""
extended-string-literal-delimiter?
extended-string-literal-delimiter →#
extended-string-literal-delimiter?quoted-text → quoted-text-item quoted-text?
quoted-text-item → escaped-character
quoted-text-item → Any Unicode scalar value except"
,\
, U+000A, or U+000Dmultiline-quoted-text → multiline-quoted-text-item multiline-quoted-text?
multiline-quoted-text-item → escaped-character
multiline-quoted-text-item → Any Unicode scalar value except\
multiline-quoted-text-item → escaped-newlineinterpolated-string-literal → string-literal-opening-delimiter interpolated-text? string-literal-closing-delimiter
interpolated-string-literal → multiline-string-literal-opening-delimiter multiline-interpolated-text? multiline-string-literal-closing-delimiterinterpolated-text → interpolated-text-item interpolated-text?
interpolated-text-item →\(
expression)
| quoted-text-itemmultiline-interpolated-text → multiline-interpolated-text-item multiline-interpolated-text?
multiline-interpolated-text-item →\(
expression)
| multiline-quoted-text-itemescape-sequence →
\
extended-string-literal-delimiter
escaped-character → escape-sequence0
| escape-sequence\
| escape-sequencet
| escape-sequencen
| escape-sequencer
| escape-sequence"
| escape-sequence'
escaped-character → escape-sequenceu
{
unicode-scalar-digits}
unicode-scalar-digits → Between one and eight hexadecimal digitsescaped-newline → escape-sequence inline-spaces? line-break
Regular Expression Literals
A regular expression literal is a sequence of characters
surrounded by slashes (/
) with the following form:
/<#regular expression#>/
Regular expression literals
must not begin with an unescaped tab or space,
and they can't contain
an unescaped slash (/
),
a carriage return, or a line feed.
Within a regular expression literal,
a backslash is understood as a part of that regular expression,
not just as an escape character like in string literals.
It indicates that the following special character
should be interpreted literally,
or that the following nonspecial character
should be interpreted in a special way.
For example,
/\(/
matches a single left parenthesis
and /\d/
matches a single digit.
A regular expression literal delimited by extended delimiters
is a sequence of characters surrounded by slashes (/
)
and a balanced set of one or more number signs (#
).
A regular expression literal
delimited by extended delimiters has the following forms:
#/<#regular expression#>/#
#/
<#regular expression#>
/#
A regular expression literal that uses extended delimiters
can begin with an unescaped space or tab,
contain unescaped slashes (/
),
and span across multiple lines.
For a multiline regular expression literal,
the opening delimiter must be at the end of a line,
and the closing delimiter must be on its own line.
Inside a multiline regular expression literal,
the extended regular expression syntax is enabled by default ---
specifically, whitespace is ignored and comments are allowed.
If you use more than one number sign to form a regular expression literal delimited by extended delimiters, don't place whitespace in between the number signs:
let regex1 = ##/abc/## // OK
let regex2 = # #/abc/# # // Error
If you need to make an empty regular expression literal, you must use the extended delimiter syntax.
Grammar of a regular expression literal:
regular-expression-literal → regular-expression-literal-opening-delimiter regular-expression regular-expression-literal-closing-delimiter
regular-expression → Any regular expressionregular-expression-literal-opening-delimiter → extended-regular-expression-literal-delimiter?
/
regular-expression-literal-closing-delimiter →/
extended-regular-expression-literal-delimiter?extended-regular-expression-literal-delimiter →
#
extended-regular-expression-literal-delimiter?
Operators
The Swift standard library defines a number of operators for your use, many of which are discussed in Basic Operators and Advanced Operators. The present section describes which characters can be used to define custom operators.
Custom operators can begin with one of the ASCII characters
/
, =
, -
, +
, !
, *
, %
, <
, >
,
&
, |
, ^
, ?
, or ~
, or one of the Unicode characters
defined in the grammar below
(which include characters from the
Mathematical Operators, Miscellaneous Symbols, and Dingbats
Unicode blocks, among others).
After the first character,
combining Unicode characters are also allowed.
You can also define custom operators
that begin with a dot (.
).
These operators can contain additional dots.
For example, .+.
is treated as a single operator.
If an operator doesn't begin with a dot,
it can't contain a dot elsewhere.
For example, +.+
is treated as
the +
operator followed by the .+
operator.
Although you can define custom operators that contain a question mark (?
),
they can't consist of a single question mark character only.
Additionally, although operators can contain an exclamation point (!
),
postfix operators can't begin with either a question mark or an exclamation point.
Note: The tokens
=
,->
,//
,/*
,*/
,.
, the prefix operators<
,&
, and?
, the infix operator?
, and the postfix operators>
,!
, and?
are reserved. These tokens can't be overloaded, nor can they be used as custom operators.
The whitespace around an operator is used to determine whether an operator is used as a prefix operator, a postfix operator, or an infix operator. This behavior has the following rules:
- If an operator has whitespace around both sides or around neither side,
it's treated as an infix operator.
As an example, the
+++
operator ina+++b
anda +++ b
is treated as an infix operator. - If an operator has whitespace on the left side only,
it's treated as a prefix unary operator.
As an example, the
+++
operator ina +++b
is treated as a prefix unary operator. - If an operator has whitespace on the right side only,
it's treated as a postfix unary operator.
As an example, the
+++
operator ina+++ b
is treated as a postfix unary operator. - If an operator has no whitespace on the left but is followed immediately by a dot (
.
), it's treated as a postfix unary operator. As an example, the+++
operator ina+++.b
is treated as a postfix unary operator (a+++ .b
rather thana +++ .b
).
For the purposes of these rules,
the characters (
, [
, and {
before an operator,
the characters )
, ]
, and }
after an operator,
and the characters ,
, ;
, and :
are also considered whitespace.
If the !
or ?
predefined operator has no whitespace on the left,
it's treated as a postfix operator,
regardless of whether it has whitespace on the right.
To use the ?
as the optional-chaining operator,
it must not have whitespace on the left.
To use it in the ternary conditional (?
:
) operator,
it must have whitespace around both sides.
If one of the arguments to an infix operator is a regular expression literal, then the operator must have whitespace around both sides.
In certain constructs, operators with a leading <
or >
may be split into two or more tokens. The remainder is treated the same way
and may be split again.
As a result, you don't need to add whitespace
to disambiguate between the closing >
characters in constructs like
Dictionary<String, Array<Int>>
.
In this example, the closing >
characters aren't treated as a single token
that may then be misinterpreted as a bit shift >>
operator.
To learn how to define new, custom operators, see AdvancedOperators#Custom-Operators and Declarations#Operator-Declaration. To learn how to overload existing operators, see AdvancedOperators#Operator-Methods.
Grammar of operators:
operator → operator-head operator-characters?
operator → dot-operator-head dot-operator-charactersoperator-head →
/
|=
|-
|+
|!
|*
|%
|<
|>
|&
||
|^
|~
|?
operator-head → U+00A1–U+00A7
operator-head → U+00A9 or U+00AB
operator-head → U+00AC or U+00AE
operator-head → U+00B0–U+00B1
operator-head → U+00B6, U+00BB, U+00BF, U+00D7, or U+00F7
operator-head → U+2016–U+2017
operator-head → U+2020–U+2027
operator-head → U+2030–U+203E
operator-head → U+2041–U+2053
operator-head → U+2055–U+205E
operator-head → U+2190–U+23FF
operator-head → U+2500–U+2775
operator-head → U+2794–U+2BFF
operator-head → U+2E00–U+2E7F
operator-head → U+3001–U+3003
operator-head → U+3008–U+3020
operator-head → U+3030operator-character → operator-head
operator-character → U+0300–U+036F
operator-character → U+1DC0–U+1DFF
operator-character → U+20D0–U+20FF
operator-character → U+FE00–U+FE0F
operator-character → U+FE20–U+FE2F
operator-character → U+E0100–U+E01EF
operator-characters → operator-character operator-characters?dot-operator-head →
.
dot-operator-character →.
| operator-character
dot-operator-characters → dot-operator-character dot-operator-characters?infix-operator → operator
prefix-operator → operator
postfix-operator → operator
Beta Software:
This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.
Learn more about using Apple's beta software (opens in a new tab).