Syntax:	gets (string)
value = fgets (string, stream)

Parameters:	string is a pointer to a array of characters. Stream is a stream identifier (a constant byte)

Returns:	undefined

Function:	Reads characters (using GETC()) into the string until a  RETURN (value 13) is encountered.  The string is terminated with a 0.  Note that INPUT.C has a more versatile GET_STRING function.

If fgets() is used then the specified stream is used where gets() defaults to STDIN (the last USE RS232).

Availability:	All devices
Requires:	#use rs232

Examples:

char string[30];

printf("Password: ");
gets(string);
if(strcmp(string, password))
               printf("OK");

Example Files:	None
Also See:	getc(), get_string in input.c