---
title: "setString(_:forType:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nspasteboard/setstring(_:fortype:)"
---

# setString(_:forType:)

Sets the given string as the representation for the specified type for the first item on the receiver.

## Declaration

```swift
func setString(_ string: String, forType dataType: NSPasteboard.PasteboardType) -> Bool
```

## Parameters

- `string`: The string to write to the pasteboard.
- `dataType`: The type of string data. The type must have been declared by a previous doc://com.apple.appkit/documentation/AppKit/NSPasteboard/declareTypes(_:owner:) message.

## Mentioned in

Supporting Writing Tools via the pasteboard

## Return Value

Return Value true if the data was written successfully, otherwise false if ownership of the pasteboard has changed. Any other error raises an NSPasteboardCommunicationException.

## Discussion

Discussion This method invokes setData(_:forType:) to perform the write.

## See Also

### Related Documentation

- [string(forType:)](appkit/nspasteboard/string(fortype:).md)

### Writing data

- [clearContents()](appkit/nspasteboard/clearcontents().md)
- [writeObjects(_:)](appkit/nspasteboard/writeobjects(_:).md)
- [setData(_:forType:)](appkit/nspasteboard/setdata(_:fortype:).md)
- [setPropertyList(_:forType:)](appkit/nspasteboard/setpropertylist(_:fortype:).md)
- [NSPasteboard.PasteboardType](appkit/nspasteboard/pasteboardtype.md)