CC-Tweaked/doc/events/paste.md

---
module: [kind=event] paste
---

<!--
SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers

SPDX-License-Identifier: LicenseRef-CCPL
-->

The @{paste} event is fired when text is pasted into the computer through Ctrl-V (or ⌘V on Mac).

## Return values
1. @{string}: The event name.
2. @{string} The text that was pasted.

## Example
Prints pasted text:
```lua
while true do
  local event, text = os.pullEvent("paste")
  print('"' .. text .. '" was pasted')
end
```
Finish the rest of the event documentation (#683) 2021-01-19 04:20:52 -05:00			`---`
			`module: [kind=event] paste`
			`---`

License CC:T according to the REUSE specification (#1351) This adds SPDX license headers to all source code files, following the REUSE[1] specification. This does not include any asset files (such as generated JSON files, or textures). While REUSE does support doing so with ".license" files, for now we define these licences using the .reuse/dep5 file. [1]: https://reuse.software/ 2023-03-15 21:52:13 +00:00			`<!--`
			`SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers`

			`SPDX-License-Identifier: LicenseRef-CCPL`
			`-->`

Finish the rest of the event documentation (#683) 2021-01-19 04:20:52 -05:00			`The @{paste} event is fired when text is pasted into the computer through Ctrl-V (or ⌘V on Mac).`

			`## Return values`
			`1. @{string}: The event name.`
			`2. @{string} The text that was pasted.`

			`## Example`
			`Prints pasted text:`
			```lua
			`while true do`
			`local event, text = os.pullEvent("paste")`
			`print('"' .. text .. '" was pasted')`
			`end`
			```