1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
\name{str_sub}
\alias{str_sub}
\title{Extract substrings from a character vector.}
\usage{
str_sub(string, start = 1L, end = -1L)
}
\arguments{
\item{string}{input character vector.}
\item{start}{integer vector giving position of first
charater in substring, defaults to first character. If
negative, counts backwards from last character.}
\item{end}{integer vector giving position of last
character in substring, defaults to last character. If
negative, counts backwards from last character.}
}
\value{
character vector of substring from \code{start} to
\code{end} (inclusive). Will be length of longest input
argument.
}
\description{
\code{str_sub} will recycle all arguments to be the same
length as the longest argument. If any arguments are of
length 0, the output will be a zero length character
vector.
}
\details{
Substrings are inclusive - they include the characters at
both start and end positions. \code{str_sub(string, 1,
-1)} will return the complete substring, from the first
character to the last.
}
\examples{
hw <- "Hadley Wickham"
str_sub(hw, 1, 6)
str_sub(hw, end = 6)
str_sub(hw, 8, 14)
str_sub(hw, 8)
str_sub(hw, c(1, 8), c(6, 14))
str_sub(hw, -1)
str_sub(hw, -7)
str_sub(hw, end = -7)
str_sub(hw, seq_len(str_length(hw)))
str_sub(hw, end = seq_len(str_length(hw)))
}
\seealso{
\code{\link{substring}} which this function wraps, and
\code{link{str_sub_replace}} for the replacement version
}
\keyword{character}
|
