README

• 正确称呼您的用户！ *

安装

$ composer require bigit/vokativ

支持的PHP版本 5.6+

使用

<?php
use Vokativ\Name;
$name = new Name();
$name->vokativ('Petr');		// 'petře'
$name->vokativ('Novák');	// 'nováku'
$name->vokativ('Adriana');	// 'adriano'
$name->vokativ('Fialová');	// 'fialová'

函数 Vokativ($name, $isWoman = null, $isLastName = null) 以单数第一格的姓氏作为第一个参数，并将其转换为第五格。函数返回值始终是类型为 string 的小写字符串。请注意，该函数可能无法正确处理外国起源的姓名。

其他可选参数包括

$isWoman

如果您希望将指定的姓名视为女性，请使用 true。

如果您希望将指定的姓名视为男性，请使用 false。

默认情况下，null 将自动检测性别。

<?php
$name->vokativ('Michel');  			// 'micheli' - automaticky jako mužské
$name->vokativ('Michel', false);	// 'micheli'
$name->vokativ('Michel', true);		// 'michel'

$isLastName

如果您希望将指定的姓名视为姓氏，请使用 true。

如果您希望将指定的姓名视为名字，请使用 false。

默认情况下，null 将自动检测名字类型。

此参数值仅影响女性姓名的变格。

<?php
$name->vokativ('Ivanova'); 				// 'ivanova' - automaticky příjmení
$name->vokativ('Ivanova', true, true);	// 'ivanova'
$name->vokativ('Ivanova', true, false);	// 'ivanovo'

自动性别检测

vokativ 库还提供了一个简单的函数，用于根据名字或姓氏检测性别。根据统计办公室的姓名频率，该函数在99.7%的情况下都能正确工作。

<?php
$name->isMale('Michal'); 	// true
$name->isMale('Novák'); 	// true
$name->isMale('Tereza'); 	// false
$name->isMale('Nováková'); 	// false

致谢

这个库是基于作者Michal Danilák的Python库Vokativ的重新实现 https://github.com/Mimino666/vokativ/。