Noms de personnes

Une ContactCard garde le nom d'une personne en un seul texte, name, et peut aussi le garder en ses parties, structuredName, un PersonName. Les parties permettent d'écrire et de trier le nom comme le fait sa culture : Charles de Gaulle se trie sous Gaulle en français, Herman Van Rompuy sous Van Rompuy en néerlandais de Belgique, et Bartók Béla s'écrit avec le nom de famille en premier en hongrois.

$name = PersonName::of(given: 'Charles', family: 'Gaulle', particle: 'de', culture: 'fr');

$name->display();   // "Charles de Gaulle"
$name->sortKey();   // "Gaulle, Charles de"

$card = ContactCard::of(structuredName: $name);
$card->name;        // "Charles de Gaulle"

Les parties

PersonName::of() rogne chaque texte ; un texte vide n'en est pas un. Un nom a un prénom ou un nom de famille, chaque partie compte 255 caractères ou moins et ne contient aucun caractère de contrôle, et une étiquette de langue a une langue de deux ou trois lettres suivie de parties d'une à huit lettres ou chiffres, 35 caractères en tout. InvalidContact est levée sinon. Sur une fiche, la forme d'affichage du nom est le name de la fiche quand on ne lui en donne pas, et elle compte aussi 255 caractères ou moins.

Écrire et trier

Prénom d'abord, display() écrit le prénom, les prénoms additionnels et le nom de famille ; nom de famille d'abord, il écrit le nom de famille, les prénoms additionnels et le prénom, comme le vietnamien écrit Võ Nguyên Giáp. Les noms chinois, japonais et coréens écrits dans leurs propres caractères sont joints sans espace, 毛泽东, et avec une espace quand ils sont romanisés, Mao Zedong.

sortKey() met d'abord le nom de famille trié, puis le prénom et les prénoms additionnels, puis ce que le tri laisse de côté de la particule : Gogh, Vincent van. Ce que la clé garde d'une particule commence par une majuscule, comme l'imprime une liste triée : Du Bellay, Joachim. Une culture qui trie par le prénom le met en premier : Giáp, Võ Nguyên. Triez les clés avec un collationneur de la langue du lecteur, Collator::compare() de ext-intl : la clé ordonne les parties, le collationneur ordonne les lettres.

Chaque méthode prend en argument facultatif une NameConvention, qui l'emporte sur la culture du nom.

Les conventions de la bibliothèque

NameConventions::for($culture) donne la convention d'une culture, selon sa langue et, pour le néerlandais, son pays :

Un nom sans culture suit la dernière ligne. Une application qui connaît mieux une culture construit sa propre NameConvention — son ordre, les premiers mots d'une particule retirés de la clé de tri, si toute la particule est retirée, si les noms se trient par le prénom, si les noms en caractères chinois, japonais ou coréens sont joints — et la donne aux méthodes.

Dans les autres formats