Skip to contents

person names methods

Details

Note that with the male/female versions if the locale doesn't provide a male/female version then we fall back to the generic thing, e.g., if no female first name we give you first name

Super class

charlatan::BaseProvider -> PersonProvider

Public fields

locale

(character) the locale

formats

(character) person name formats

person

(character) person name data

messy

(logical) the messy setting, TRUE or FALSE

Methods

Inherited methods


Method allowed_locales()

fetch the allowed locales for this provider

Usage

PersonProvider$allowed_locales()


Method new()

Create a new PersonProvider object

Usage

PersonProvider$new(locale = NULL, messy = FALSE)

Arguments

locale

(character) the locale to use. See $allowed_locales() for locales supported (default: en_US)

messy

(logical) make some messy data. Default: FALSE

Returns

A new PersonProvider object


Method render()

Make a person's name

Usage

PersonProvider$render(fmt = NULL)

Arguments

fmt

(character) a name format, default: NULL


Method first_name()

make a first name

Usage

PersonProvider$first_name()


Method first_name_female()

make a female first name

Usage

PersonProvider$first_name_female()


Method first_name_male()

make a male first name

Usage

PersonProvider$first_name_male()


Method last_name()

make a last name

Usage

PersonProvider$last_name()


Method last_name_female()

make a female last name

Usage

PersonProvider$last_name_female()


Method last_name_male()

make a male last name

Usage

PersonProvider$last_name_male()


Method prefix()

make a name prefix

Usage

PersonProvider$prefix()


Method prefix_female()

make a female name prefix

Usage

PersonProvider$prefix_female()


Method prefix_male()

make a male name prefix

Usage

PersonProvider$prefix_male()


Method suffix()

make a name suffix

Usage

PersonProvider$suffix()


Method suffix_female()

make a female name suffix

Usage

PersonProvider$suffix_female()


Method suffix_male()

make a male name suffix

Usage

PersonProvider$suffix_male()


Method clone()

The objects of this class are cloneable with this method.

Usage

PersonProvider$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

x <- PersonProvider$new()
x$locale
#> [1] "en_US"
x$render()
#> [1] "Rosemarie Kihn"
x$first_name()
#> [1] "Jamel"
x$first_name_female()
#> [1] "Carisa"
x$first_name_male()
#> [1] "Tolbert"
x$last_name()
#> [1] "Hoppe"
x$last_name_female()
#> [1] "Kassulke"
x$last_name_male()
#> [1] "Mayert"

x <- PersonProvider$new(locale = "en_GB")
x$locale
#> [1] "en_GB"
x$render()
#> [1] "Ms. Irene Thomas"
x$first_name()
#> [1] "Ross"
x$first_name_female()
#> [1] "Rebecca"
x$first_name_male()
#> [1] "Geoffrey"
x$last_name()
#> [1] "Moss"
x$last_name_female()
#> [1] "Bailey"
x$last_name_male()
#> [1] "Bartlett"

z <- PersonProvider$new(locale = "fr_FR")
z$locale
#> [1] "fr_FR"
z$render()
#> [1] "Maggie Thibault"
z$first_name()
#> [1] "Geneviève"
z$first_name_female()
#> [1] "Susan"
z$first_name_male()
#> [1] "Thibaut"
z$last_name()
#> [1] "Ollivier"
z$last_name_female()
#> [1] "Brun"
z$last_name_male()
#> [1] "Thibault"
z$prefix()
#> [1] "L'"

z <- PersonProvider$new(locale = "de_AT")
z$locale
#> [1] "de_AT"
z$render()
#> [1] "Paula Just"
z$first_name()
#> [1] "Jonas"
z$last_name()
#> [1] "Müllner"
z$prefix()
#> [1] "Dipl.-Ing."

z <- PersonProvider$new(locale = "cs_CZ")
z$locale
#> [1] "cs_CZ"
z$render()
#> [1] "Ing. Sabina Čermáková"
z$first_name()
#> [1] "Marcel"
z$first_name_female()
#> [1] "Žaneta"
z$first_name_male()
#> [1] "Patrik"
z$last_name()
#> [1] "Vlček"
z$last_name_female()
#> [1] "Vávrová"
z$last_name_male()
#> [1] "Štěpánek"
z$prefix()
#> [1] "slečna"

z <- PersonProvider$new(locale = "es_MX")
z$locale
#> [1] "es_MX"
z$render()
#> [1] "Mateo Navarro Ocasio"
z$first_name()
#> [1] "Flavio"
z$first_name_female()
#> [1] "Isabel"
z$first_name_male()
#> [1] "Estela"
z$last_name()
#> [1] "Griego"
z$prefix()
#> [1] "Ing."

z <- PersonProvider$new(locale = "en_NZ")
z$locale
#> [1] "en_NZ"
z$render()
#> [1] "James Frost"
z$first_name()
#> [1] "Kate"
z$first_name_female()
#> [1] "Kate"
z$first_name_male()
#> [1] "Jacob"
z$last_name()
#> [1] "Rose"

PersonProvider$new(locale = "fr_CH")$render()
#> [1] "Frédéric Deshusses"
PersonProvider$new(locale = "fi_FI")$render()
#> [1] "Haanpää, Lenni"
PersonProvider$new(locale = "fa_IR")$render()
#> [1] "حنانه پویان"
PersonProvider$new(locale = "es_ES")$render()
#> [1] "Jose Angel Sebastián Carrasco"
PersonProvider$new(locale = "de_DE")$render()
#> [1] "Zehra Hahn"
PersonProvider$new(locale = "de_AT")$render()
#> [1] "Fabian Denk"
PersonProvider$new(locale = "cs_CZ")$render()
#> [1] "Mgr. Karolína Poláková DiS."
PersonProvider$new(locale = "bg_BG")$render()
#> [1] "Христилияна Мангъфова"
PersonProvider$new(locale = "da_DK")$render()
#> [1] "Dr. Jens Thorsen"