*** UNIX MANUAL PAGE BROWSER ***

rpmatch(3) Library Functions Manual rpmatch(3) NAME rpmatch - Determines whether a response is affirmative or negative LIBRARY Standard C Library (libc.a) SYNOPSIS #include <stdlib.h> int rpmatch( const char *response); PARAMETERS User input entered in response to a question that requires an affirma- tive or negative answer. DESCRIPTION The rpmatch() function determines whether the string value of the re- sponse parameter matches the affirmative or negative response expres- sion as specified by the LC_MESSAGES category in the program's current locale. Both response expressions, defined in the locale, may be ex- tended regular expressions. A possible value of the affirmative expression, yesexpr, for a English- language locale is "^([yY]|[yY][eE][sS])". This expression will match any value of the response parameter that has consists of the letter Y (in uppercase or lowercase) or the letters YES (in any mixture of up- percase and lowercase letters). EXAMPLES The following example requests a response from the user and uses the rpmatch() function to determine if the response is affirmative or nega- tive. #include <stdlib.h> #include <stdio.h> #include <locale.h> #include <string.h> #define SLENGTH 80 main() { char str[SLENGTH], *eol; int ans; (void)setlocale(LC_ALL, ""); printf("Do you want to perform this operation: "); fgets(str, SLENGTH, stdin); if ((eol = strchr(str, '\n')) != NULL) *eol = '\0'; /* Replace newline with null */ else return; /* Line entered too long */ ans = rpmatch(str); if (ans == 1) printf("You responded affirmatively\n"); else if (ans == 0) printf("You responded negatively\n"); else printf("Your answer did not match\n"); } RETURN VALUES A value of 1 is returned if the string value of the response parameter is matched by the affirmative expression; a value of 0 (zero) is re- turned if the string value of the response parameter is matched by the negative expression. If neither expression matches the string value of the response parameter, a value of -1 is returned. RELATED INFORMATION Commands: grep(1). Functions: regcomp(3), regexec(3), setlocale(3). Files: locale(4). delim off rpmatch(3)