# range(of:options:locale:) Returns the range of a substring in the attributed string, if it exists. ``` func range(of stringToFind: T, options: String.CompareOptions = [], locale: Locale? = nil) -> Range? where T : StringProtocol ``` ## Parameters `stringToFind` The string to find. `options` Options that affect the search behavior, such as case-insensivity, search direction, and regular expression matching. `locale` The locale to use when searching, or `nil` to use the current locale. The default is `nil`. ## Return Value The range where `stringToFind` exists in the attributed string, or `nil` if it isn’t present. --- 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)