PC Extra Super CD 1998 January/PCPLUS131.iso/DJGPP/V2/DJLSR201.ZIP/src/libc/compat/stdlib/getlongp.txh

Text File | 1995-07-23 | 851 b | 32 lines

@node getlongpass, misc
@subheading Syntax

@example
#include <stdlib.h>

int  getlongpass(const char *prompt, char *password, int max_length)
@end example

@subheading Description

This function reads up to a Newline (CR or LF) or EOF (Ctrl-D or Ctrl-Z)
from the standard input, without an echo, after prompting with a
null-terminated string @var{prompt}.  It puts a null-terminated string of
at most @var{max_length - 1} first characters typed by the user into a
buffer pointed to by @var{password}.  Pressing Ctrl-C or Ctrl-Break will
cause the calling program to @code{exit(1)}.

@subheading Return Value

Zero if successfull, -1 on error (and @var{errno} is set to and
appropriate value.

@subheading Example

@example
char password[MAX_PASS];

(void)getlongpass("Password: ", password, MAX_PASS);
@end example