.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (C) 2006 Justin Pryzby .\" .\" %%%LICENSE_START(PERMISSIVE_MISC) .\" Permission is hereby granted, free of charge, to any person obtaining .\" a copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including .\" without limitation the rights to use, copy, modify, merge, publish, .\" distribute, sublicense, and/or sell copies of the Software, and to .\" permit persons to whom the Software is furnished to do so, subject to .\" the following conditions: .\" .\" The above copyright notice and this permission notice shall be .\" included in all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, .\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. .\" IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY .\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, .\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" .\" References: .\" glibc manual and source .\" .\" 2006-05-19, mtk, various edits and example program .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH rpmatch 3 "15 июня 2024 г." "Справочные страницы Linux 6.9.1" .SH ИМЯ rpmatch \- определяет, является ли ответ на вопрос утвердительным или отрицательным .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .P \fBint rpmatch(const char *\fP\fIresponse\fP\fB);\fP .fi .P .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .P \fBrpmatch\fP(): .nf начиная с glibc 2.19: _DEFAULT_SOURCE glibc 2.19 и старее: _SVID_SOURCE .fi .SH ОПИСАНИЕ Функция \fBrpmatch\fP() обрабатывает ответ пользователя «да» или «нет» на вопросы, учитывая интернационализацию. .P В аргументе \fIresponse\fP должен указываться ответ пользователя в виде строки, заканчивающейся null, полученной, например, с помощью \fBfgets\fP(3) или \fBgetline\fP(3). .P Пользовательские языковые настройки определяются с помощью переменных окружения \fBLANG\fP, \fBLC_MESSAGES\fP и \fBLC_ALL\fP, если для их учёта программа вызывала \fBsetlocale\fP(3). .P Regardless of the locale, responses matching \fB\[ha][Yy]\fP are always accepted as affirmative, and those matching \fB\[ha][Nn]\fP are always accepted as negative. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" После проверки \fIresponse\fP, функция \fBrpmatch\fP() возвращает 0 при найденном отрицательном ответе («нет»), 1 при положительном ответе («да») и \-1, когда значение \fIresponse\fP не распознано. .SH ОШИБКИ Возвращаемое значение \-1 может указывать на неправильные входные данные, либо какую\-то другую ошибку. Не стоит проверять является ли возвращаемое значение лишь отличным от нуля. .P Функция \fBrpmatch\fP() может завершиться с ошибкой по любой из причин, по которым могут не выполниться \fBregcomp\fP(3) или \fBregexec\fP(3); причина ошибки не указывается в \fIerrno\fP или где\-то ещё — это указывает на ошибку в самом механизме regex (но этот случай не отличается от нераспознанных значений \fIresponse\fP). .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBrpmatch\fP() T} Безвредность в нитях MT\-Safe locale .TE .SH СТАНДАРТЫ None. .SH ИСТОРИЯ GNU, FreeBSD, AIX. .SH ОШИБКИ The \fBYESEXPR\fP and \fBNOEXPR\fP of some locales (including "C") only inspect the first character of the \fIresponse\fP. This can mean that "yno" et al. resolve to \fB1\fP. This is an unfortunate historical side\-effect which should be fixed in time with proper localisation, and should not deter from \fBrpmatch\fP() being the proper way to distinguish between binary answers. .SH ПРИМЕРЫ Следующая программа показывает результаты, когда в \fBrpmatch\fP() передана строка, полученная программой из командной строки. .P .\" SRC BEGIN (rpmatch.c) .EX #define _DEFAULT_SOURCE #include #include #include #include \& int main(int argc, char *argv[]) { if (argc != 2 || strcmp(argv[1], "\-\-help") == 0) { fprintf(stderr, "%s response\[rs]n", argv[0]); exit(EXIT_FAILURE); } \& setlocale(LC_ALL, ""); printf("rpmatch() returns: %d\[rs]n", rpmatch(argv[1])); exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "СМОТРИТЕ ТАКЖЕ" \fBfgets\fP(3), \fBgetline\fP(3), \fBnl_langinfo\fP(3), \fBregcomp\fP(3), \fBsetlocale\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) aereiae , Azamat Hackimov , Dmitriy S. Seregin , Katrin Kutepova , Lockal , Yuri Kozlov , Баринов Владимир и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .