rpmatch(3)

ИМЯ
rpmatch - определяет, является ли ответ на вопрос утвердительным или отрицательным

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <stdlib.h>

int rpmatch(const char *response);

    Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

rpmatch():
    начиная с glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 и старее:
        _SVID_SOURCE

ОПИСАНИЕ
Функция rpmatch() обрабатывает ответ пользователя «да» или «нет» на вопросы, учитывая интернационализацию.

В аргументе response должен указываться ответ пользователя в виде строки, заканчивающейся null, полученной, например, с помощью fgets(3) или getline(3).

Пользовательские языковые настройки определяются с помощью переменных окружения LANG, LC_MESSAGES и LC_ALL, если для их учёта программа вызывала setlocale(3).

Regardless of the locale, responses matching ^[Yy] are always accepted as affirmative, and those matching ^[Nn] are always accepted as negative.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
После проверки response, функция rpmatch() возвращает 0 при найденном отрицательном ответе («нет»), 1 при положительном ответе («да») и -1, когда значение response не распознано.

ОШИБКИ
Возвращаемое значение -1 может указывать на неправильные входные данные, либо какую-то другую ошибку. Не стоит проверять является ли возвращаемое значение лишь отличным от нуля.

Функция rpmatch() может завершиться с ошибкой по любой из причин, по которым могут не выполниться regcomp(3) или regexec(3); причина ошибки не указывается в errno или где-то ещё — это указывает на ошибку в самом механизме regex (но этот случай не отличается от нераспознанных значений response).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
rpmatch() | Безвредность в нитях | MT-Safe locale

СТАНДАРТЫ
rpmatch() is not required by any standard, but available under the GNU C library, FreeBSD, and AIX.

ДЕФЕКТЫ
The YESEXPR and NOEXPR of some locales (including "C") only inspect the first character of the response. This can mean that "yno" et al. resolve to 1. This is an unfortunate historical side-effect which should be fixed in time with proper localisation, and should not deter from rpmatch() being the proper way to distinguish between binary answers.

ПРИМЕРЫ
Следующая программа показывает результаты, когда в rpmatch() передана строка, полученная программой из командной строки.

    #define _DEFAULT_SOURCE
    #include <locale.h>
    #include <stdio.h>
    #include <stdlib.h>
    #include <string.h>
    int
    main(int argc, char *argv[])
    {
        if (argc != 2 || strcmp(argv[1], "--help") == 0) {
            fprintf(stderr, "%s response\n", argv[0]);
            exit(EXIT_FAILURE);
        }
        setlocale(LC_ALL, "");
        printf("rpmatch() returns: %d\n", rpmatch(argv[1]));
        exit(EXIT_SUCCESS);
    }

СМ. ТАКЖЕ
fgets(3), getline(3), nl_langinfo(3), regcomp(3), setlocale(3)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан aereiae <aereiae@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Lockal <lockalsash@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Баринов Владимир и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.