Copyright Digital Equipment Corp. All rights reserved.

Description

   The fgetws function reads wide characters from the specified file
   and stores them in the array pointed to by wstr. The function
   reads up to maxchar-1 characters or until the new-line character
   is read, converted, and transferred to wstr, or until an end-
   of-file condition is encountered. The function terminates the
   line with a null wide character. fgetws places the new-line that
   terminates the input line into the user buffer, unless maxchar
   characters have already been fetched.