stringr (version 0.6.1)

str_match: Extract first matched group from a string.

Description

Vectorised over string. pattern should be a single pattern, i.e. a character vector of length one.

Usage

str_match(string, pattern)

Arguments

pattern

pattern to look for, as defined by a POSIX regular expression. Pattern should contain groups, defined by (). See the ``Extended Regular Expressions'' section of regex for details.

string

input vector. This must be an atomic vector, and will be coerced to a character vector

Value

• character matrix. First column is the complete match, followed by one for each capture group

Examples

strings <- c("219 733 8965", "329-293-8753 ", "banana", "595 794 7569",
  "387 287 6718", "apple", "233.398.9187  ", "482 952 3315",
  "239 923 8115", "842 566 4692", "Work: 579-499-7527", "$1000",
  "Home: 543.355.3679")
phone <- "([2-9][0-9]{2})[- .]([0-9]{3})[- .]([0-9]{4})"

str_extract(strings, phone)
str_match(strings, phone)