Updating Buffer "Value" Names to "Header" Names
- Proposal: SE-0114
- Author: Erica Sadun
- Review Manager: Chris Lattner
- Status: Implemented (Swift 3)
- Decision Notes: Rationale
- Implementation: apple/swift#3374
This proposal updates parameters and generic type parameters from
value names to
header names for
All user-facing Swift APIs must go through Swift Evolution. While this is a trivial API change with an existing implementation, this formal proposal provides a paper trail as is normal and usual for this process.
This change introduces better semantics for buffer types.
This update affects
The generic parameters
<Value, Element> become
<Header, Element> in affected classes.
Each use of
Value in type members is renamed to
Header. Affected members include
create(minimumCapacity:makingHeaderWith:) -> Header
- Initializers that refer to
Impact on Existing Code
Existing third party code will need migration using a simple fixit.