diff --git a/stdlib/public/core/Span/RawSpan.swift b/stdlib/public/core/Span/RawSpan.swift index 094800b801fd6..eef47aeb2c18d 100644 --- a/stdlib/public/core/Span/RawSpan.swift +++ b/stdlib/public/core/Span/RawSpan.swift @@ -30,10 +30,10 @@ public struct RawSpan: ~Escapable, Copyable, BitwiseCopyable { /// The starting address of this `RawSpan`. /// - /// `_pointer` can be `nil` if and only if `_count` equals 0. - /// Otherwise, `_pointer` must point to memory that will remain - /// valid and not mutated as long as this `Span` exists. - /// The memory at `_pointer` must consist of `_count` initialized bytes. + /// If `_count` is zero, `_pointer` may point to valid memory or it may be `nil`, + /// but no accesses may be performed through it. Otherwise, `_pointer` must point + /// to initialized memory containing `_count` bytes, which must remain valid and + /// not be mutated during the lifetime of this `RawSpan`. @usableFromInline internal let _pointer: UnsafeRawPointer? diff --git a/stdlib/public/core/Span/Span.swift b/stdlib/public/core/Span/Span.swift index 281ef226663a5..f4e84c9389455 100644 --- a/stdlib/public/core/Span/Span.swift +++ b/stdlib/public/core/Span/Span.swift @@ -30,11 +30,10 @@ public struct Span: ~Escapable, Copyable, BitwiseCopyable { /// The starting address of this `Span`. /// - /// `_pointer` can be `nil` if and only if `_count` equals 0. - /// Otherwise, `_pointer` must point to memory that will remain - /// valid and not mutated as long as this `Span` exists. - /// The memory at `_pointer` must be initialized - /// as `_count` instances of `Element`. + /// If `_count` is zero, `_pointer` may point to valid memory or it may be `nil`, + /// but no accesses may be performed through it. Otherwise, `_pointer` must point + /// to initialized memory containing `_count` instances of `Element`, which must + /// remain valid and not be mutated during the lifetime of this `Span`. @usableFromInline internal let _pointer: UnsafeRawPointer?