clipr v0.7.0

0

Monthly downloads

0th

Percentile

Read and Write from the System Clipboard

Simple utility functions to read from and write to the Windows, OS X, and X11 clipboards.

Readme

clipr

CRAN
status. Downloads, grand
total Travis-CI
Build
Status AppVeyor Build
Status Coverage
Status

Simple utility functions to read and write from the system clipboards of Windows, OS X, and Unix-like systems (which require either xclip or xsel.)

Installation

Install from CRAN

install.packages("clipr")

Or try the development version

devtools::install_github("mdlincoln/clipr")

Usage

library("clipr")
#> Welcome to clipr. See ?write_clip for advisories on writing to the clipboard in R.

cb <- read_clip()

clipr is pipe-friendly, and will default to returning the same object that was passed in.

res <- write_clip(c("Text", "for", "clipboard"))
res
#> [1] "Text"      "for"       "clipboard"

To capture the string that clipr writes to the clipboard, specify return_new = TRUE. Character vectors with length > 1 will be collapsed with system-appropriate line breaks, unless otherwise specified


cb <- write_clip(c("Text", "for", "clipboard"), return_new = TRUE)
cb
#> [1] "Text\nfor\nclipboard"

cb <- write_clip(c("Text", "for", "clipboard"), breaks = ", ", return_new = TRUE)
cb
#> [1] "Text, for, clipboard"

write_clip also tries to intelligently handle data.frames and matrices, rendering them with write.table so that they can be pasted into a spreadsheet like Excel.

tbl <- data.frame(a = c(1, 2, 3), b = c(4, 5, 6))
cb <- write_clip(tbl, return_new = TRUE)
cb
#> [1] "a\tb\n1\t4\n2\t5\n3\t6"

read_clip_tbl will try to parse clipboard contents from spreadsheets into data frames directly.

Developing with clipr

See the “Developing with clipr” vignette included with this package for advisories on writing code that calls clipr functions.

Nice uses of clipr

(a non-comprehensive list)

  1. reprex by @jennybc takes R code on the clipboard and renders a reproducible example from it, ready to then paste on to GitHub, Stack Overflow, or the like.
  2. datapasta by @milesmcbain eases the copying and pasting of R objects in and out of different sources (Excel, Google Sheets).

Matthew Lincoln

Functions in clipr

Name Description
read_clip_tbl Transforms output of read_clip() into data frame.
read_clip Read clipboard
clipr_available Is the system clipboard available?
clear_clip Clear clipboard
write_last_clip Write contents of the last R expression to the clipboard
clipr clipr: Read and Write from the System Clipboard
write_clip Write clipboard
No Results!

Vignettes of clipr

Name
developing-with-clipr.Rmd
No Results!

Last month downloads

Details

Type Package
License GPL-3
URL https://github.com/mdlincoln/clipr
BugReports https://github.com/mdlincoln/clipr/issues
VignetteBuilder knitr
Encoding UTF-8
Language en-US
LazyData TRUE
RoxygenNote 6.1.1
SystemRequirements xclip (https://github.com/astrand/xclip) or xsel (http://www.vergenet.net/~conrad/software/xsel/) for accessing the X11 clipboard
NeedsCompilation no
Packaged 2019-07-23 02:33:48 UTC; admin
Repository CRAN
Date/Publication 2019-07-23 05:00:03 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/clipr)](http://www.rdocumentation.org/packages/clipr)