C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
gets
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The gets function reads a line from the standard input stream
     stdin and stores it in <buffer>. The line consists of all
     characters up to and including the first newline character (\n).
     The gets function then replaces the newline character with a null
     character (\0) before returning the line. In contrast, the fgets
     function retains the newline character.
 
     Return Value
 
     If successful, the gets function returns its argument. A NULL
     pointer indicates an error or end-of-file condition. Use ferror or
     feof to determine which one has occurred.
                                    -♦-