mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
Apply changes from editorial review.
This commit is contained in:
@@ -200,13 +200,13 @@ where SubSequence: MutableCollection
|
|||||||
/// contiguous mutable storage of the entire collection. If no such storage
|
/// contiguous mutable storage of the entire collection. If no such storage
|
||||||
/// exists, the collection creates it. If the collection doesn't support an
|
/// exists, the collection creates it. If the collection doesn't support an
|
||||||
/// internal representation in the form of contiguous mutable storage, this
|
/// internal representation in the form of contiguous mutable storage, this
|
||||||
/// method doesn't call `body` but instead immediately returns `nil`.
|
/// method doesn't call `body` --- it immediately returns `nil`.
|
||||||
///
|
///
|
||||||
/// The optimizer can often eliminate bounds- and uniqueness-checking
|
/// The optimizer can often eliminate bounds- and uniqueness-checking
|
||||||
/// within an algorithm. When that fails, however, invoking the same
|
/// within an algorithm. When that fails, however, invoking the same
|
||||||
/// algorithm on the `buffer` argument may let you trade safety for speed.
|
/// algorithm on the `buffer` argument may let you trade safety for speed.
|
||||||
///
|
///
|
||||||
/// Your closure should always perform any necessary cleanup, because the
|
/// Always perform any necessary cleanup in the closure, because the
|
||||||
/// method makes no guarantees about the state of the collection if the
|
/// method makes no guarantees about the state of the collection if the
|
||||||
/// closure throws an error. Your changes to the collection may be absent
|
/// closure throws an error. Your changes to the collection may be absent
|
||||||
/// from the collection after throwing the error, because the closure could
|
/// from the collection after throwing the error, because the closure could
|
||||||
@@ -215,7 +215,7 @@ where SubSequence: MutableCollection
|
|||||||
///
|
///
|
||||||
/// - Warning: Your `body` closure must not replace `buffer`. This leads
|
/// - Warning: Your `body` closure must not replace `buffer`. This leads
|
||||||
/// to a crash in all implementations of this method within the standard
|
/// to a crash in all implementations of this method within the standard
|
||||||
/// library
|
/// library.
|
||||||
///
|
///
|
||||||
/// Successive calls to this method may provide a different pointer on each
|
/// Successive calls to this method may provide a different pointer on each
|
||||||
/// call. Don't store `buffer` outside of this method.
|
/// call. Don't store `buffer` outside of this method.
|
||||||
|
|||||||
@@ -387,10 +387,10 @@ public protocol Sequence {
|
|||||||
/// Executes a closure on the sequence’s contiguous storage.
|
/// Executes a closure on the sequence’s contiguous storage.
|
||||||
///
|
///
|
||||||
/// This method calls `body(buffer)`, where `buffer` is a pointer to the
|
/// This method calls `body(buffer)`, where `buffer` is a pointer to the
|
||||||
/// collection’s contiguous storage. If no such storage exists, the collection
|
/// collection’s contiguous storage. If the contiguous storage doesn't exist,
|
||||||
/// creates it. If the collection doesn’t support an internal representation
|
/// the collection creates it. If the collection doesn’t support an internal
|
||||||
/// in a form of contiguous storage, the method doesn’t call `body` but
|
/// representation in a form of contiguous storage, the method doesn’t call
|
||||||
/// instead immediately returns `nil`.
|
/// `body` --- it immediately returns `nil`.
|
||||||
///
|
///
|
||||||
/// The optimizer can often eliminate bounds- and uniqueness-checking
|
/// The optimizer can often eliminate bounds- and uniqueness-checking
|
||||||
/// within an algorithm. When that fails, however, invoking the same
|
/// within an algorithm. When that fails, however, invoking the same
|
||||||
|
|||||||
Reference in New Issue
Block a user