Parse a Full Name into Components

Parses a full name string into components such as salutation, first name, middle name, last name, suffix, status, and inferred gender.

Usage

parse_name(x, prefixes = prx, suffixes = sfx, sanitize = FALSE)

Arguments

x

A character string representing a person's name.

prefixes

A character vector of salutations/prefixes to remove. Defaults to prx.

suffixes

A character vector of suffixes to remove. Defaults to sfx.

sanitize

Logical; if TRUE, run sanitize_input() on x first. Set FALSE (the default) when the input has already been sanitized, as parse_names() does for the whole vector.

Value

A one-row data.frame with columns salutation, first_name, middle_name, last_name, suffix, status, gender, and gender_confidence.

Examples

parse_name("LIVINGSTON III MICHAEL JOHN")
#>   salutation first_name middle_name  last_name suffix status gender
#> 1               MICHAEL        JOHN LIVINGSTON    III             M
#>   gender_confidence
#> 1              99.6
parse_name("livingston III,  Mr. MICHAEL JOHN9", sanitize = TRUE)
#>   salutation first_name middle_name  last_name suffix status gender
#> 1         MR    MICHAEL        JOHN LIVINGSTON    III             M
#>   gender_confidence
#> 1              99.6