class Faker::Name

Public Class Methods

female_first_name() click to toggle source

Produces a random female first name.

@return [String]

@example

Faker::Name.female_first_name #=> "Natasha"

@faker.version 1.9.1

# File lib/faker/default/name.rb, line 75
def female_first_name
  fetch('name.female_first_name')
end
Also aliased as: first_name_women, feminine_name
feminine_name()
Alias for: female_first_name
first_name() click to toggle source

Produces a random first name.

@return [String]

@example

Faker::Name.first_name #=> "Kaci"

@faker.version 0.9.0

# File lib/faker/default/name.rb, line 43
def first_name
  if parse('name.first_name').empty?
    fetch('name.first_name')
  else
    parse('name.first_name')
  end
end
first_name_men()
Alias for: male_first_name
first_name_neutral()
Alias for: neutral_first_name
first_name_women()
Alias for: female_first_name
gender_neutral_first_name()
Alias for: neutral_first_name
initials(legacy_number = NOT_GIVEN, number: 3) click to toggle source

Produces random initials.

@param number [Integer] Number of digits that the generated initials should have. @return [String]

@example

Faker::Name.initials            #=> "NJM"
Faker::Name.initials(number: 2) #=> "NM"

@faker.version 1.8.5

# File lib/faker/default/name.rb, line 147
def initials(legacy_number = NOT_GIVEN, number: 3)
  warn_for_deprecated_arguments do |keywords|
    keywords << :number if legacy_number != NOT_GIVEN
  end

  (0...number).map { rand(65..90).chr }.join
end
last_name() click to toggle source

Produces a random last name.

@return [String]

@example

Faker::Name.last_name #=> "Ernser"

@faker.version 0.9.0

# File lib/faker/default/name.rb, line 105
def last_name
  parse('name.last_name')
end
Also aliased as: middle_name
male_first_name() click to toggle source

Produces a random male first name.

@return [String]

@example

Faker::Name.male_first_name #=> "Edward"

@faker.version 1.9.1

# File lib/faker/default/name.rb, line 60
def male_first_name
  fetch('name.male_first_name')
end
Also aliased as: first_name_men, masculine_name
masculine_name()
Alias for: male_first_name
middle_name()
Alias for: last_name
name() click to toggle source

Produces a random name.

@return [String]

@example

Faker::Name.name #=> "Tyshawn Johns Sr."

@faker.version 0.9.0

# File lib/faker/default/name.rb, line 17
def name
  parse('name.name')
end
name_with_middle() click to toggle source

Produces a random name with middle name.

@return [String]

@example

Faker::Name.name_with_middle #=> "Aditya Elton Douglas"

@faker.version 1.6.4

# File lib/faker/default/name.rb, line 30
def name_with_middle
  parse('name.name_with_middle')
end
neutral_first_name() click to toggle source

Produces a random gender neutral first name.

@return [String]

@example

Faker::Name.neutral_first_name #=> "Casey"

@faker.version 2.13.0

# File lib/faker/default/name.rb, line 90
def neutral_first_name
  fetch('name.neutral_first_name')
end
prefix() click to toggle source

Produces a random name prefix.

@return [String]

@example

Faker::Name.prefix #=> "Mr."

@faker.version 0.9.0

# File lib/faker/default/name.rb, line 119
def prefix
  fetch('name.prefix')
end
suffix() click to toggle source

Produces a random name suffix.

@return [String]

@example

Faker::Name.suffix #=> "IV"

@faker.version 0.9.0

# File lib/faker/default/name.rb, line 132
def suffix
  fetch('name.suffix')
end