---
title: "replaceCharacters(in:withRTF:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nstext/replacecharacters(in:withrtf:)"
---

# replaceCharacters(in:withRTF:)

Replaces the characters in the given range with RTF text interpreted from the given RTF data.

## Declaration

```swift
func replaceCharacters(in range: NSRange, withRTF rtfData: Data)
```

## Parameters

- `range`: The range of characters to be replaced.
- `rtfData`: The RTF data from which to derive the replacement string.

## Discussion

Discussion This method applies only to rich text objects. This method does not include undo support by default. Clients must invoke shouldChangeText(inRanges:replacementStrings:) or shouldChangeText(in:replacementString:) to include this method in an undoable action. This method is designed for transferring text from out-of-process sources such as the pasteboard. In most cases, programmatic modification of the text is best done by operating on the text storage directly, using the general methods of NSMutableAttributedString.

## See Also

### Replacing text

- [replaceCharacters(in:withRTFD:)](appkit/nstext/replacecharacters(in:withrtfd:).md)
- [replaceCharacters(in:with:)](appkit/nstext/replacecharacters(in:with:).md)