GETSTR

Section: C Library Functions (3)
Updated: 10/23/82
Index Return to Main Contents
 

NAME

getstr, getstab, getsearch - ask user to type a string  

SYNOPSIS

#include <stdio.h>

char *getstr (prompt,defalt,answer);
char *prompt,*defalt,*answer;

int getstab (prompt,table,defalt);
int getsearch (prompt,table,defalt);
char *prompt,**table,*defalt;  

DESCRIPTION

Getstr will print prompt as a message to the user, and ask for the user to type an input string. The string is then copied into answer. If the user types just a carriage return, then the string defalt is copied into answer. Answer and defalt may be the same string; in this case, the default value will be the original contents of answer.

Getstab will print prompt as a message to the user, and ask for an input string. The string typed will be sought within the string table table, and, if found, the index of this string will be returned. If the user types just a carriage return, then the string defalt will be assumed. If nothing in the table matches the input string, or if more than one string matches, then an error message is printed and the prompt-and-response cycle is repeated. The string table may be declared this way:

        char *table[] = {
                "first string",
                "second string",
                ...
                "n-th string",
                0};

Getsearch is just like getstab, but performs a heuristic test for the quality of each string match, and returns the index of the best match. If the match is not exact, the user is asked to approve or disapprove the choice of the matching string; if he disapproves, several other closely matching choices are listed.  

SEE ALSO

stablk(3), stlmatch(3), getint(3), getbool(3), etc.
strarg(3), stabarg(3)
srchscore(3), stabsearch(3), searcharg(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 11:12:47 GMT, November 04, 2022