Склонение представлений объектов в зуп 3.1

Платный доступ

Если вам нужно склонение больших объемов, зарегистрируйтесь и оплатите подходящий вам тарифный план:

Как приобрести платный доступ: цены, условия, инструкции

Примечание 1: при оплате любого тарифа снимаются .

Примечание 2: тарификация осуществляется по следующему принципу:
каждые 100 символов исходного текста эквивалентны 1 запросу. Если в теле вызова функции russian/addstressmarks указан текст,
длина которого менее 100 символов, то такой вызов функции russian/addstressmarks считается эквивалентным 1 запросу к веб-сервису.
Здесь под символом текста подразумеваются не только буквы русского алфавита, но также любые цифры, знаки препинания, пробелы, прочие знаки и буквы других алфавитов.
При этом следует иметь в виду, что один перенос текста на новую строку может являться двумя символами, если он передан в Windows-стиле, т.е. как пара символов CR LF (см. статью в Википедии на эту тему).

Чтобы стать платным пользователем, вам нужно:

• Зарегистрироваться.
• Войти в раздел Управление подпиской и оплатить доступ по одному из вышеперечисленных тарифов.
• Сгенерировать токен.
• Добавить к запросу к веб-сервису ваш токен (как это сделать, см. ).

Склонение прилагательных по родам

string ИзменитьРод (string прилагательное, РодЧисло родЧисло);
    

Функция принимает на вход полное прилагательное в форме именительного падежа мужского рода, а также род и число, в которые его необходимо поставить.
Вот пример функции, которая согласует прилагательное с существительным:

string Согласовать (string прилагательное, string существительное)
{
    return склонятель.ИзменитьРод (прилагательное, 
           склонятель.Проанализировать (существительное).РодЧисло) + " " + существительное;
}

Для прилагательного острый и существительных нож, бритва, копье, ножницы
функция выдаст соответственно:

• острый нож
• острая бритва
• острое копье
• острые ножницы

Функция возвращает null, если:

• входная строка равна null;
• входная строка не может быть распознана как одно полное прилагательное или причастие
  в форме мужского рода именительного падежа единственного числа.

Необходимо учитывать, что смысл прилагательного может меняться в зависимости от существительного. Так, острое зрение и острый вкус
не такие же острые, как острый нож.

Снятие неоднозначности дополнительными признаками

Русский язык богат всевозможными двусмысленностями, которые затрудняют задачу склонения.

Например, слово банки может склоняться как банок или банков – смотря что имелось в виду.
Имя Карен может склоняться или не склоняться в зависимости от того, принадлежит оно мужчине,
или женщине.
Для разрешения подобного рода неоднозначностей предусмотрена возможность указания так называемых дополнительных признаков.
Вот как может измениться результат склонения в зависимости от указанного признака:

Программа делает все возможное, чтобы угадать, что имелось в виду. Попробуйте, например, просклонять:

• Август и
  август
• Любовь и
  любовь

Как видно из примеров, в сомнительных случаях программа ориентируется на заглавные буквы.
Но что делать, если, например, пользователи вашего сайта любят вводить свои имена и ники
маленькими буквами? Для этого есть возможность указать программе, что
входная строка содержит ФИО или псевдоним, а не что-то другое. Таким образом неоднозначность будет устранена.

Купить модуль morpher для PHP

Примечания:

1. Поддержка включает в себя консультации по использованию модуля по телефону и электронной почте.
   Наши контакты.
2. Гарантия работоспособности и отсутствия дефектов. Если вы обнаружите в модуле дефекты, такие как зависание,
   аварийное завершение работы или несоответствие документации, мы обязуемся устранить эти дефекты.
   Неправильное склонение или определение рода не признается дефектом.
3. Обновления. При выходе новой версии вы сможете скачать ее бесплатно по той же самой ссылке (ссылка будет выслана вам в письме).
4. Модуль под Linux-версию PHP поставляется в виде исходных кодов на C++ и для сборки требует
   настроенного и работающего набора инструментов компилятора gcc версии 4.7 и выше.
   По нашему опыту примерно 20% пользователей требуется помощь с настройкой gcc.
   Помощь обычно предоставляется через ssh-соединение к вашему терминалу.
   Заказать сборку под (еще) одну платформу можно у нас за 3000 р.

Процесс покупки лицензии «Бизнес» займет всего несколько минут.

Использование библиотеки

Весь API библиотеки Morpher.Russian.Speller.dll можно схематично представить следующим кодом:

namespace Morpher.Russian
{
    public class DateSpeller
    {
        public DateSpeller(OrdinalSpeller ordinalSpeller);

        public string SpellDate (
            DateTime date, 
            Падеж падеж = Падеж.Именительный,
            bool useOne = false);
    }

    public class OrdinalSpeller
    {
        public OrdinalSpeller(Склонятель склонятель);

        public string SpellOrdinal (
            long number,
            bool useOne = false);

        public OrdinalResult AgreeOrdinal (
            string ordinal,
            string unit,
            Падеж падеж = Падеж.Именительный);
    }
}

Функция прописи даты

public string SpellDate (
    DateTime date,
    Падеж падеж = Падеж.Именительный,
    bool useOne = false);

Параметры:

1. date – дата для прописи. Значение времени в этом параметре будет проигнорировано.
2. падеж – падеж, в который необходимо поставить дату.
3. useOne – писать ли «одна» перед словом «тысяча»:
   тысяча девятьсот пятого года или
   одна тысяча девятьсот пятого года.

Функция возвращает дату прописью, например
первое января две тысячи первого года.

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

var склонятель = new Склонятель("%YOUR KEY%");
var ordinalSpeller = new OrdinalSpeller(склонятель);
var dateSpeller = new DateSpeller(ordinalSpeller);

// «Сегодня двадцать второе июля две тысячи девятнадцатого года»
Console.WriteLine ("Сегодня {0}", 
    dateSpeller.SpellDate(DateTime.Now));

// «01.05.2018 в творительном падеже: первым мая две тысячи восемнадцатого года»
Console.WriteLine ("01.05.2018 в творительном падеже: {0}", 
    dateSpeller.SpellDate(new DateTime(2018, 5, 1), Падеж.Творительный));

Функция прописи порядковых числительных

public string SpellOrdinal (long number, bool useOne = false);

Параметры:

1. number – число для прописи.
2. useOne – добавлять ли слово «один»: (одна) тысяча первый, (одно)миллионный и т.п.

Функция возвращает порядковое числительное прописью в мужском роде (которое потом можно просклонять в нужный род методом AgreeOrdinal).

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

// «миллиард двести тридцать четыре миллиона пятьсот шестьдесят семь тысяч восемьсот девяностый»
Console.WriteLine (ordinalSpeller.SpellOrdinal (1234567890));

// «один миллиард двести тридцать четыре миллиона пятьсот шестьдесят семь тысяч восемьсот девяностый»
Console.WriteLine (ordinalSpeller.SpellOrdinal (1234567890, useOne: true));

Функция склонения порядковых числительных по падежам и родам

public OrdinalResult AgreeOrdinal (string ordinal, string unit, Падеж падеж = Падеж.Именительный);

Параметры:

1. ordinal – порядковое числительное в мужском роде, например, пятый.
2. unit – единица измерения, с которой нужно согласовать числительное, например, колесо.
3. падеж – падеж, в который необходимо поставить числительное и единицу измерения (пятое колесо, пятого колеса, пятому колесу…).

Функция возвращает исходные порядковое числительное и единицу измерения в указанном падеже в виде структуры OrdinalResult:

public struct OrdinalResult
{
    public string Ordinal; // порядковое числительное
    public string Unit;    // единица измерения
}

Числительное, кроме склонения по падежам, согласуется с единицей измерения по роду, числу и одушевленности:

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

OrdinalResult r = ordinalSpeller.AgreeOrdinal ("первый", "свидание");
Console.WriteLine ("{0} {1}", r.Ordinal, r.Unit); // «первое свидание» 

Технические характеристики

Модуль имеет версии для Linux и Windows. Мак пока не поддерживается.

Поддерживаемые версии PHP: 5.2, 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4.

Работа расширения была успешно протестирована в следующих дистрибутивах Linux:

• Debian 7 (Wheezy), Debian 8 (Jessie), Debian 9 (Stretch);
• Ubuntu 14 (Trusty), Ubuntu 16 (Xenial), Ubuntu 18 (Bionic);
• CentOS 7.

Модуль также может успешно использоваться в FreeBSD актуальных версий.

Работа модуля была проверена на веб-серверах Apache и lighttpd.

Модуль не требует для своей работы подключения к Интернету и не передает никакие данные в Интернет.

Ограничения

• При попытке просклонять принципиально несклоняемое слово (например, глагол)
  программа не выдает ошибку, а пытается просклонять его как сможет: например,
  глагол давать программа может просклонять подобно существительному кровать.
• Не реализовано склонение числительных (три кота), однако есть функция преобразования числа,
  заданного цифрами, в пропись и склонения его вместе с единицей измерения,
  что позволяет при заданном количестве (3) и единице измерения (кот) получить словосочетание
  три кота, трёх котов, трём котам и т.д. во всех падежах.
• Для ФИО формы множественного числа не выдаются.
• Не всегда правильно склоняются словосочетания с наречиями
  (в будущем планируется устранить это ограничение).
• Могут неправильно склоняться словосочетания с причастными оборотами: жаренная на масле картошка.
  Такие обороты практически не встречаются в названиях товаров, городов, должностей, т.е. в том материале,
  для склонения которого обычно используется Морфер.
• Для слов из разряда singularia tantum
  программа строит несуществующее множественное число:
  молоко,
  еда.
• Сочетания «нарицательное + собственное» лучше склонять раздельно, например:
  программист Петров, город Калининград.

История изменений

Пользовательский словарь (russian/userdict, ukrainian/userdict)

Веб-сервис поддерживает исправление склонения по требованию пользователя.
Для этого имеются 3 метода:

Все функции пользовательского словаря требуют
и при его отсутствии возвращают ошибку с кодом 25 и статусом 400 или ошибку с кодом 9 и статусом 498, если указанный токен не найден.
Исправления видны только пользователю с указанным токеном.

Добавить или изменить исправление

Для добавления или изменения исправления нужно отправить POST запрос на /russian/userdict
(/ukrainian/userdict для украинского языка соответственно).
Тело запроса должно быть представлено в формате
,
который используется по умолчанию для POST-запросов.
Например, если мы хотим изменить дательный падеж для слова «Кошка»,
то тело запроса будет иметь вид:

И=Кошка&Д=Пантере

Н=Кiшка&Д=Пантерi

Для добавления исправления обязательно нужно указывать именительный падеж и хотя бы еще одну падежную форму.

Названия параметров (russian/userdict)

Названия параметров (ukrainian/userdict)

Повторный вызов метода с уже существующим исправлением добавит или изменит текущее исправление.
Если мы захотим к нашему исправлению «Кошка» добавить еще родительный падеж, нам достаточно будет передать «И=Кошка&Р=Пантеры».
В итоге останется старое исправление на дательный падеж и добавится новое на родительный.
Если мы вызовем метод еще раз с дательным или родительным падежом, мы изменим текущее исправление для этих падежей.

Метод POST может возвращать следующие ошибки:

Получить список исправлений

/russian/userdict/ukrainian/userdict

Пример ответа:

<?xml version="1.0" encoding="utf-8"?>
<dictionary>
    <Entry>
        <singular>
            <И>Кошка</И>
            <Р>Пантеры</Р>
            <Д>Пантере</Д>
        </singular>
    </Entry>
<dictionary>

XSD схема ответа на russian/userdict: Russian.xsd

XSD схема ответа на ukrainian/userdict: Ukrainian.xsd

Удаление исправления

Для того чтобы удалить исправление, достаточно передать DELETE запрос вида:

Например, чтобы удалить все исправления для слова «Кошка», нужно передать:

Для украинского языка:

Метод DELETE может возвращать следующие ошибки:

История изменений