strwrap
Wrap Character Strings to Format Paragraphs
Each character string in the input is first split into paragraphs (or lines containing whitespace only). The paragraphs are then formatted by breaking lines at word boundaries. The target columns for wrapping lines and the indentation of the first and all subsequent lines of a paragraph can be controlled independently.
- Keywords
- character
Usage
strwrap(x, width = 0.9 * getOption("width"), indent = 0,
exdent = 0, prefix = "", simplify = TRUE, initial = prefix)Arguments
- x
a character vector, or an object which can be converted to a character vector by
as.character.- width
a positive integer giving the target column for wrapping lines in the output.
- indent
a non-negative integer giving the indentation of the first line in a paragraph.
- exdent
a non-negative integer specifying the indentation of subsequent lines in paragraphs.
- prefix, initial
a character string to be used as prefix for each line except the first, for which
initialis used.- simplify
a logical. If
TRUE, the result is a single character vector of line text; otherwise, it is a list of the same length asxthe elements of which are character vectors of line text obtained from the corresponding element ofx. (Hence, the result in the former case is obtained by unlisting that of the latter.)
Details
Whitespace (space, tab or newline characters) in the input is destroyed. Double spaces after periods, question and explanation marks (thought as representing sentence ends) are preserved. Currently, possible sentence ends at line breaks are not considered specially.
Indentation is relative to the number of characters in the prefix string.
Value
A character vector (if simplify is TRUE), or a list of
such character vectors, with declared input encodings preserved.
Examples
library(base)
# NOT RUN {
## Read in file 'THANKS'.
x <- paste(readLines(file.path(R.home("doc"), "THANKS")), collapse = "\n")
## Split into paragraphs and remove the first three ones
x <- unlist(strsplit(x, "\n[ \t\n]*\n"))[-(1:3)]
## Join the rest
x <- paste(x, collapse = "\n\n")
## Now for some fun:
writeLines(strwrap(x, width = 60))
writeLines(strwrap(x, width = 60, indent = 5))
writeLines(strwrap(x, width = 60, exdent = 5))
writeLines(strwrap(x, prefix = "THANKS> "))
## Note that messages are wrapped AT the target column indicated by
## 'width' (and not beyond it).
## From an R-devel posting by J. Hosking <jh910@juno.com>.
x <- paste(sapply(sample(10, 100, replace = TRUE),
function(x) substring("aaaaaaaaaa", 1, x)), collapse = " ")
sapply(10:40,
function(m)
c(target = m, actual = max(nchar(strwrap(x, m)))))
# }