Executes a closure on the sequence’s contiguous storage.
func withContiguousStorageIfAvailable<R>(_ body: (UnsafeBufferPointer<Element>) throws -> R) rethrows -> R?
A closure that receives an
UnsafeBufferPointerto the sequence’s contiguous storage.
The value returned from
body, unless the sequence doesn’t support contiguous storage, in which case the method ignores
body and returns
This method calls
buffer is a pointer to the collection’s contiguous storage. If the contiguous storage doesn’t exist, the collection creates it. If the collection doesn’t support an internal representation in a form of contiguous storage, the method doesn’t call
body — it immediately returns
The optimizer can often eliminate bounds- and uniqueness-checking within an algorithm. When that fails, however, invoking the same algorithm on the
buffer argument may let you trade safety for speed.
Successive calls to this method may provide a different pointer on each call. Don’t store
buffer outside of this method.
Collection that provides its own implementation of this method must provide contiguous storage to its elements in the same order as they appear in the collection. This guarantees that it’s possible to generate contiguous mutable storage to any of its subsequences by slicing
buffer with a range formed from the distances to the subsequence’s