ecommercebox/vocative-polish-firstname

Component for remake first name to Polish vocative. Odmiana polskich imion na wołacz

VocativePolishFirstName

Component for remake first name to Polish vocative, _(*1)

Installation

Install the library by adding it to your composer.json or running:, _(*2)

composer require "ecommercebox/vocative-polish-firstname:*"

How to use

Create object with first name, you can setup encoding and own "titles" as optional arguments. First name is converted to first letter up., _(*3)

//required
$input = 'MARIUSZ';

//optional
$encoding = "UTF-8";
//default group ['U' => 'Panie/Pani', 'M' => 'Panie', 'W' => 'Pani'];
//override default group titles
$titles = ['U' => '', 'M' => 'Drogi Panie', 'W' => 'Droga Pani'];
//override or add new exeptions, where W = Woman, M = Man
$exeptions = [
    'Ola' => ['W', 'Oluu'],
    'Jan' => ['M', 'Janku']
];

//init object
$name = new \ecbox\VocativePolishFirstName($input, $encoding, $titles, $exeptions);

Setup additional titles group, _(*4)

$titles = ['U' => 'Szanowna(y) Pani(e)', 'M' => 'Szanowny Panie', 'W' => 'Szanowna Pani'];
$name->setTitles($titles, 'polite');

Get vocative first name with default title definition. Optional argument $delimiter, default is space and title definition group name, _(*5)

echo $name->getVocativeString();
// output: Drogi Panie Mariuszu

Get vocative first name with custom title definition. Optional argument $delimiter, default is space and title definition group name, _(*6)

echo $name->getVocativeString('polite');
// output: Szanowny Panie Mariuszu

Get vocative first name, _(*7)

echo $name->getVocativeFirstName();
// output: Mariuszu

Get default title for first name, _(*8)

echo $name->getDetectedTitle();
// output: Drogi Panie

Get custom group title for first name, _(*9)

echo $name->getDetectedTitle('polite');
// output: Szanowny Panie

Check if male, _(*10)

echo $name->isMale();
// output: true if yes

Check if woman, _(*11)

echo $name->isWoman();
// output: true if yes

Get array, _(*12)

$array = $name->getVocativeArray();
// array: ['M', "Mariuszu"];
// where M: Male, W: Woman, U: Unknown

Test results

You can check quality using test file: testVocativePolishFirstName, _(*13)

We are using dictionary test. See results!, _(*14)

Test date: 2016-07-11, _(*15)

Total dictionary names: 1704, _(*16)

Differences: 0, _(*17)

The percentage of errors: 0%, _(*18)

License

MIT license. See the LICENSE file for more details., _(*19)