mirror of
https://github.com/apple/swift.git
synced 2026-10-08 12:50:50 +02:00
Chris Adamson
d0d078517a
This PR updates files in the `stdlib.docc` directory to provide curation for symbols added to the standard library in release 6.4, including task cancellation shields and refs. The [stdlib documentation on docs.swift.org](https://docs.swift.org/latest/documentation/swift) uses these files to organize the online documentation into topics. This PR doesn't affect any compilable source. It's only for the use of the `docc` compiler to produce documentation, either in swift.org's CI or if someone wants to generate a local copy. rdar://181594680
72 lines
1.8 KiB
Markdown
72 lines
1.8 KiB
Markdown
# ``Swift``
|
|
|
|
Build apps using a powerful open language.
|
|
|
|
## Overview
|
|
|
|
Swift includes modern features like type inference, optionals, and closures, which
|
|
make the syntax concise yet expressive. Swift ensures your code is fast and efficient,
|
|
while its memory safety and native error handling make the language safe by design.
|
|
Writing Swift code is interactive and fun in Swift Playgrounds, playgrounds in Xcode,
|
|
and the REPL.
|
|
|
|
```swift
|
|
var interestingNumbers = [
|
|
"primes": [2, 3, 5, 7, 11, 13, 17],
|
|
"triangular": [1, 3, 6, 10, 15, 21, 28],
|
|
"hexagonal": [1, 6, 15, 28, 45, 66, 91]
|
|
]
|
|
|
|
for key in interestingNumbers.keys {
|
|
interestingNumbers[key]?.sort(by: >)
|
|
}
|
|
|
|
print(interestingNumbers["primes"]!)
|
|
// Prints "[17, 13, 11, 7, 5, 3, 2]"
|
|
```
|
|
|
|
### Learn Swift
|
|
|
|
If you're new to Swift, read [The Swift Programming Language](https://docs.swift.org/swift-book/)
|
|
for a quick tour, a comprehensive language guide, and a full reference manual. If
|
|
you're new to programming, check out [Swift Playgrounds](https://www.apple.com/swift/playgrounds/)
|
|
on iPad.
|
|
|
|
Swift is developed in the open. To learn more about the open source Swift project
|
|
and community, visit [Swift.org](https://swift.org).
|
|
|
|
## Topics
|
|
|
|
### Standard Library
|
|
|
|
- <doc:swift-standard-library>
|
|
|
|
### Observation
|
|
|
|
- <doc:Observation-collection>
|
|
|
|
### Distributed Actors
|
|
|
|
- <doc:Distributed-collection>
|
|
|
|
### Regular Expression DSL
|
|
|
|
- <doc:RegexBuilder-collection>
|
|
|
|
### Low-Level Atomic Operations
|
|
|
|
- <doc:Synchronization-collection>
|
|
|
|
### Data Modeling
|
|
|
|
- <doc:choosing-between-structures-and-classes>
|
|
- <doc:adopting-common-protocols>
|
|
|
|
### Language Interoperability with C and C++
|
|
|
|
- <doc:customizing-your-c-code-for-swift>
|
|
- <doc:using-imported-c-structs-and-unions-in-swift>
|
|
- <doc:using-imported-c-functions-in-swift>
|
|
- <doc:using-imported-c-macros-in-swift>
|
|
|