Adds an attribute with the given name and value to the characters in the specified range.
SDKs
- iOS 3.2+
- macOS 10.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Foundation
Declaration
func addAttribute(_ name: NSAttributed String.Key, value: Any, range: NSRange)
Parameters
name
A string specifying the attribute name. Attribute keys can be supplied by another framework or can be custom ones you define. For information about the system-supplied attribute keys, see the Constants section in
NSAttributed
.String value
The attribute value associated with
name
.aRange
The range of characters to which the specified attribute/value pair applies.
Discussion
You may assign any name
/value
pair you wish to a range of characters. Raises an invalid
if name
or value
is nil
and an range
if any part of a
lies beyond the end of the receiver’s characters.