# data(from:documentAttributes:) Returns a data object that contains a text stream corresponding to the characters and attributes within the specified range. ``` func data(from range: NSRange, documentAttributes dict: [NSAttributedString.DocumentAttributeKey : Any] = [:]) throws -> Data ``` ## Parameters `range` The range. `dict` A required dictionary specifying the document attributes. The dictionary contains values from `Document Types` and must at least contain [`documentType`](/documentation/Foundation/NSAttributedString/DocumentAttributeKey/documentType). ## Return Value Returns the data for the attributed string, or `nil` if failure. When `nil`, `error` encapsulates the error information. ## Discussion Raises an [`rangeException`](/documentation/Foundation/NSExceptionName/rangeException) if any part of `range` lies beyond the end of the receiver’s characters. > Handling Errors in Swift: > In Swift, this method returns a nonoptional result and is marked with the `throws` keyword to indicate that it throws an error in cases of failure. > > You call this method in a `try` expression and handle any errors in the `catch` clauses of a `do` statement, as described in [Error Handling](https://docs.swift.org/swift-book/LanguageGuide/ErrorHandling.html) in [The Swift Programming Language](https://docs.swift.org/swift-book/) and `About Imported Cocoa Error Parameters`. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)