Name Generator for C++

‍Requires C++23 (e.g., -std=c++23 for GCC/Clang, /std:c++latest for MSVC).

API Reference · Usage Guide · Releases

Features

• Name Generation. Randomly generates first names from popular name databases, organized by gender and culture.
• Surname Generation. Randomly generates surnames, organized by culture.
• Full Name Chaining. Append one or more names and surnames with an intuitive chainable API.
• 23 Cultures Supported. American, Argentinian, Australian, Brazilian, British, Bulgarian, Canadian, Chinese, Danish, Finnish, French, German, Kazakh, Mexican, Norwegian, Polish, Portuguese, Russian, Spanish, Swedish, Turkish, Ukrainian.
• ISO 2-Letter Codes. to_culture() and to_gender() for converting strings to enums.
• Deterministic Seeding. Per-call get_name(gender, culture, seed) for reproducible results, generator-level seed() / unseed() for deterministic sequences, and name::seed() for replaying a previous generation.
• Resource Inspection. has_resources() lets you verify databases loaded before generating.
• Multi-Instance Support. Construct independent ng instances with their own name databases and random engine.

Integration

namegen.hpp is the single required file released here. You need to add

#include <dasmig/namegen.hpp>
 
// For convenience.
using ng = dasmig::ng;

to the files you want to generate names and set the necessary switches to enable C++23 (e.g., -std=c++23 for GCC and Clang).

Additionally you must supply the name generator with the resources folder also available in the release.

Usage

Due to the necessity of supporting multiple culture characters and the way std::string works on Windows, this library uses std::wstring for all generated names.

When requesting a name for the first time the library will attempt to load the resource files (the default path is ./resources). Manually load the resources folder if it's in a different location.

#include <dasmig/namegen.hpp>
 
using ng = dasmig::ng;
 
// Manually load the resources folder if necessary.
ng::instance().load("path/to/resources");
 
// Generate a name of any culture and any gender.
std::wstring name = ng::instance().get_name();
 
// Generate a female name of any culture.
std::wstring female_name = ng::instance().get_name(dasmig::gender::f);
 
// Generate a male Bulgarian name.
std::wstring bulgarian = ng::instance().get_name(dasmig::gender::m,
                                                  dasmig::culture::bulgarian);
 
// Generate a full name: first + two surnames.
std::wstring full = ng::instance().get_name().append_surname().append_surname();
 
// Access individual parts.
auto n = ng::instance().get_name().append_surname();
for (const auto& part : n.parts())
    std::wcout << part << L" ";
 
// Deterministic generation — same seed always produces the same name.
auto seeded = ng::instance().get_name(dasmig::gender::m,
                                       dasmig::culture::american, 42);
 
// Replay a previous name using its seed.
auto replay = ng::instance().get_name(dasmig::gender::m,
                                       dasmig::culture::american,
                                       seeded.seed());
 
// Seed the engine for a deterministic sequence.
ng::instance().seed(100);
// ... generate names ...
ng::instance().unseed(); // restore non-deterministic state
 
// Independent instance with its own databases and engine.
ng my_gen;
my_gen.load("path/to/resources");
std::wstring name2 = my_gen.get_name().append_surname();

For the complete feature guide — cultures, chaining, thread safety, seeding, and more — see the Usage Guide.

Disclaimer

Ukrainian and Russian surnames are all in their male or neutral versions.