xref: /webtrees/app/SurnameTradition/DefaultSurnameTradition.php (revision 1062a1429914c995339f502856821457aa975a5a)
1323788f4SGreg Roach<?php
2323788f4SGreg Roach/**
3323788f4SGreg Roach * webtrees: online genealogy
4*1062a142SGreg Roach * Copyright (C) 2018 webtrees development team
5323788f4SGreg Roach * This program is free software: you can redistribute it and/or modify
6323788f4SGreg Roach * it under the terms of the GNU General Public License as published by
7323788f4SGreg Roach * the Free Software Foundation, either version 3 of the License, or
8323788f4SGreg Roach * (at your option) any later version.
9323788f4SGreg Roach * This program is distributed in the hope that it will be useful,
10323788f4SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
11323788f4SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12323788f4SGreg Roach * GNU General Public License for more details.
13323788f4SGreg Roach * You should have received a copy of the GNU General Public License
14323788f4SGreg Roach * along with this program. If not, see <http://www.gnu.org/licenses/>.
15323788f4SGreg Roach */
16323788f4SGreg Roachnamespace Fisharebest\Webtrees\SurnameTradition;
17323788f4SGreg Roach
18323788f4SGreg Roach/**
19323788f4SGreg Roach * All family members keep their original surname
20323788f4SGreg Roach */
21323788f4SGreg Roachclass DefaultSurnameTradition implements SurnameTraditionInterface {
22323788f4SGreg Roach	/** Extract a GIVN from a NAME */
23323788f4SGreg Roach	const REGEX_GIVN = '~^(?<GIVN>[^/ ]+)~';
24323788f4SGreg Roach
25323788f4SGreg Roach	/** Extract a SPFX and SURN from a NAME */
269797fe2eSGreg Roach	const REGEX_SPFX_SURN = '~(?<NAME>/(?<SPFX>[a-z’\']{0,4}(?: [a-z’\']{1,4})*) ?(?<SURN>[^/]*)/)~';
27323788f4SGreg Roach
28323788f4SGreg Roach	/** Extract a simple SURN from a NAME */
29323788f4SGreg Roach	const REGEX_SURN = '~(?<NAME>/(?<SURN>[^/]+)/)~';
30323788f4SGreg Roach
31323788f4SGreg Roach	/** Extract two Spanish/Portuguese SURNs from a NAME */
32323788f4SGreg Roach	const REGEX_SURNS = '~/(?<SURN1>[^ /]+)(?: | y |/ /|/ y /)(?<SURN2>[^ /]+)/~';
33323788f4SGreg Roach
34323788f4SGreg Roach	/**
35323788f4SGreg Roach	 * Does this surname tradition change surname at marriage?
36323788f4SGreg Roach	 *
37323788f4SGreg Roach	 * @return bool
38323788f4SGreg Roach	 */
39323788f4SGreg Roach	public function hasMarriedNames() {
40323788f4SGreg Roach		return false;
41323788f4SGreg Roach	}
42323788f4SGreg Roach
43323788f4SGreg Roach	/**
44c1ec7145SGreg Roach	 * Does this surname tradition use surnames?
45c1ec7145SGreg Roach	 *
46c1ec7145SGreg Roach	 * @return bool
47c1ec7145SGreg Roach	 */
48c1ec7145SGreg Roach	public function hasSurnames() {
49c1ec7145SGreg Roach		return true;
50c1ec7145SGreg Roach	}
51c1ec7145SGreg Roach
52c1ec7145SGreg Roach	/**
53323788f4SGreg Roach	 * What names are given to a new child
54323788f4SGreg Roach	 *
55323788f4SGreg Roach	 * @param string $father_name A GEDCOM NAME
56323788f4SGreg Roach	 * @param string $mother_name A GEDCOM NAME
57323788f4SGreg Roach	 * @param string $child_sex   M, F or U
58323788f4SGreg Roach	 *
59323788f4SGreg Roach	 * @return string[] Associative array of GEDCOM name parts (SURN, _MARNM, etc.)
60323788f4SGreg Roach	 */
61323788f4SGreg Roach	public function newChildNames($father_name, $mother_name, $child_sex) {
6213abd6f3SGreg Roach		return [
63323788f4SGreg Roach			'NAME' => '//',
6413abd6f3SGreg Roach		];
65323788f4SGreg Roach	}
66323788f4SGreg Roach
67323788f4SGreg Roach	/**
68323788f4SGreg Roach	 * What names are given to a new parent
69323788f4SGreg Roach	 *
70323788f4SGreg Roach	 * @param string $child_name A GEDCOM NAME
71323788f4SGreg Roach	 * @param string $parent_sex M, F or U
72323788f4SGreg Roach	 *
73323788f4SGreg Roach	 * @return string[] Associative array of GEDCOM name parts (SURN, _MARNM, etc.)
74323788f4SGreg Roach	 */
75323788f4SGreg Roach	public function newParentNames($child_name, $parent_sex) {
7613abd6f3SGreg Roach		return [
77323788f4SGreg Roach			'NAME' => '//',
7813abd6f3SGreg Roach		];
79323788f4SGreg Roach	}
80323788f4SGreg Roach
81323788f4SGreg Roach	/**
82323788f4SGreg Roach	 * What names are given to a new spouse
83323788f4SGreg Roach	 *
84323788f4SGreg Roach	 * @param string $spouse_name A GEDCOM NAME
85323788f4SGreg Roach	 * @param string $spouse_sex  M, F or U
86323788f4SGreg Roach	 *
87323788f4SGreg Roach	 * @return string[] Associative array of GEDCOM name parts (SURN, _MARNM, etc.)
88323788f4SGreg Roach	 */
89323788f4SGreg Roach	public function newSpouseNames($spouse_name, $spouse_sex) {
9013abd6f3SGreg Roach		return [
91323788f4SGreg Roach			'NAME' => '//',
9213abd6f3SGreg Roach		];
93323788f4SGreg Roach	}
94323788f4SGreg Roach}
95