NameCaseLib/README.md

# NameCaseLib
Библиотека для PHP5 позволяет склонять по падежам Фамилию Имя Отчество. Имеет очень хороший алгоритм склонения Имен, Отчеств и Фамилий. Это первая публичная версия библиотеки. Пожалуйста оставляйте все свои пожелания и замечания.
## Туториал
Встроенные константы
-----------

* NCLNameCaseRu::$IMENITLN - именительный падеж
* NCLNameCaseRu::$RODITLN - родительные падеж
* NCLNameCaseRu::$DATELN - дательные падеж
* NCLNameCaseRu::$VINITELN - винительный падеж
* NCLNameCaseRu::$TVORITELN - творительный падеж
* NCLNameCaseRu::$PREDLOGN - предложный падеж


Пример использования
-----------

echo 'Отчет, ' .
 $nc->q("Афонин Николай Сергеевич", NCLNameCaseRu::$RODITLN)
 . ' о проделаной работе вместе с его сыном ' .
 $nc->q("Афонин Никита", NCLNameCaseRu::$TVORITELN) .
 ' на осенних каникулах. Задание держалось на ' .
 $nc->q("Маргаритта Николаевна", NCLNameCaseRu::$PREDLOGN) .
 '; Поздравляем всех предчастных, в том числе и ' .
 $nc->q("Кардонский Серафим Ильич", NCLNameCaseRu::$VINITELN) . ' и ' .
 $nc->q("Лобудская София Викторовна", NCLNameCaseRu::$VINITELN) .
 '. Хотим передать поздравление также ' .
 $nc->q("Игнатьев Павел Викторович", NCLNameCaseRu::$DATELN) . ' и ' .
 $nc->q("Сумарский Лев", NCLNameCaseRu::$DATELN);


Результат выполнения
-----------
Отчет, Афонина Николая Сергеевича о проделаной работе вместе с его сыном Афониным Никитой на осенних каникулах. Задание держалось на Маргаритте Николаевне; Поздравляем всех предчастных, в том числе и Кардонского Серафима Ильича и Лобудскую Софию Викторовну. Хотим передать поздравление также Игнатьеву Павлу Викторовичу и Сумарскому Льву
Документация
-----------
Полная документация находится в разработке.
Дополнительные демонстрации находятся в папке Tutorial

Лицензия
-----------
Dual licensed under the MIT or GPL Version 2 licenses.

## 0.1.2 (2011-05-05)
- Написана функция поиска имени, фамилии, отчества в строке.
- Добавлена функция быстрого склонения NCLNameCaseRu::q(), которая принимает обязательный параметр ФИО в любом формате и возвращает строку в нужно падеже.

## 0.1.1 (2011-05-03)
- Написана функция определения пола NCLNameCaseRu::GenderAutoDetect() — отлично справляется с парами Имя Фамилия, по моим тестам дает 100% прохождение тестов (2000 пар имен и фамилий). Если указано отчество, пол определает без проблем.Для просто имен вероятность правильного определения больше 98,5%. Для просто фамилий — больше 96%.

## 0.1.0 (2011-05-01)
- Первая версия библиотеки