Functions of FUNCky II used on GENSIX.PRG:
=========================================


 Name:    M_squeak()
 Usage:   M_squeak() -> NIL


 Params:  None

 Returns:

      Nothing

 Description:

      Sounds the  speaker.


 Name:    isdir()
 Usage:   isdir(dirname) -> lStatus


 Params:  string dirname   - A character string containing the directory
                             name to verify.

 Returns:

      TRUE if the directory name specified via <dirname> is valid,  FALSE
      if not or error.

 Description:

      isdir() can be  used  to  check  if  the  directory  specified  via
      <dirname> is valid. <dirname> can contain a drive  letter  or  path
      designations. Wildcard characters cannot  be  used.  If  necessary,
      isfile() can be used to  check  for  directories  using  wild  card
      characters.

      If the specified directory exists and is valid, TRUE  is  returned.
      If not or error, FALSE is returned  and  ferror()  is  set  to  the
      error value that DOS reported.


 Name:    fparsefn()
 Usage:   fparsefn(filename) -> cFname


 Params:  string filename  - A character string containing the file name.

 Returns:

      A character string containing the name portion of  the  file  name.
      If there is no name present in the passed string the  return  value
      will contain a NULLSTR.

 Description:

      fparsfn() parses  out  the  name  portion  from  a  file  name  and
      returns  it  as  a  character  string.  The  name  portion  of  the
      filename is the first 8 characters  before  the  period  separating
      it from the extension. If the file name does  not  contain  a  name
      portion, a NULLSTR is returned.

      You can use the return from fparsefn() as a component to fmake().


 Name:    fcopy()
 Usage:   fcopy(source, dest) -> nBytes


 Params:  string source    - A character string containing the file name to
                             copy from.
          string dest      - A character string containing the file name to
                             copy to.

 Returns:

      A long equal to the total number of bytes  copied  or  ERROR  if  a
      disk or file error occurs.

 Description:

      fcopy() will copy the the file designated by <source> to  the  file
      designated by <dest>. If the  file  designated  by  <dest>  already
      exists it is first truncated to 0 bytes before copying.

      If successful, fcopy() returns the total number of bytes copied  as
      a long. The date stamp of the new file will be set equal to that of
      the old file.

      If a file read or disk error occurs, ERROR is returned and the file
      designated by <dest> is deleted.


 Name:    feof()
 Usage:   feof(handle) -> lStatus


 Params:  int handle       - A handle from a previous call to fopen() or
                             fcreate().

 Returns:

      FALSE if the file pointer of the file associated with  <handle>  is
      not at the end of the file. TRUE if it is or error.

 Description:

      feof() checks that the file pointer associated with <handle> is  at
      the end of file. If the file pointer is at the  end  of  the  file,
      TRUE is returned. If the file pointer has not yet reached  the  end
      of file, FALSE is returned.

      If <handle> is invalid or an error occurs,  TRUE  is  returned  and
      ferror() is set to the error value that DOS reported.


 Name:    freadline()
 Usage:   freadline(handle) -> cLine


 Params:  int handle       - A handle returned from a previous call to
                             fopen() or fcreate().

 Returns:

      A character string containing the  null  terminated  line  of  text
      starting at the current file pointer position. If an error  occurs,
      the return value will contain a NULLSTR.

 Description:

      freadline() will read in a line of text  starting  at  the  current
      file pointer position. The final CR/LF (for MS DOS files) or  final
      LF (for non MS DOS files) will be removed. The resultant  character
      string will be null terminated.

      The maximum length of a line is determined by an internal  variable
      that can  be  set  via  the  flinelen()  function.  If  no  newline
      character  is  found  after  scanning  the  number  of   characters
      specified via the flinelen() function, the line is considered to be
      complete and the text is returned null terminated. This  is  useful
      to limit the length  of  any  given  line  that  may  be  read  via
      freadline().

      The default line length value is 512 characters, not including  the
      null terminator that will be appended to the end of a  line  should
      it reach the 512 byte limit. For maximum speed and efficiency,  you
      should set the line length as close to the size of  the  lines  you
      plan to read. Keep in mind that the final newline character(s) must
      be counted. It is OK to leave a little extra room. If you  set  the
      line length less than the size of a  line  of  text  in  the  file,
      peculiar results will be returned. Make sure  you  leave  a  little
      extra for safe keeping. The line length should never be set to more
      than 2048 characters. Any attempt to set the  line  length  greater
      than 2048 will be truncated to 2048.

      In addition, the line terminator  character  can  be  set  via  the
      fnewline() function. By default, the new line character is  set  to
      ascii 10 (newline). You can however set it to other ascii values if
      you wish to create your own style delimited files. Each  'line'  of
      text that ends in the newline  character  is  considered  to  be  a
      completed line. Any CR or LF characters embedded  within  the  text
      between the newline character you defined will be stripped out  and
      will not appear in the final text string, nor will they affect  the
      count of lines in the file. You should use the function  fnewline()
      to set the newline character.

      If there is an error reading the  file,  then  a  NULLSTR  will  be
      returned. To distinguish between a blank line and a file error, you
      should use ferror() to determine if a file error occurred.


 Name:    fwriteline()
 Usage:   fwriteline(handle, str) -> lStatus


 Params:  int handle       - A handle returned from a previous call to
                             fopen() or fcreate().
          string str       - The character string to write to the file.

 Returns:

      TRUE if the character string was successfully written to the  file,
      FALSE if error.

 Description:

      fwriteline() writes a null terminated character string to the  file
      associated with <handle>. A CR/LF combination is  appended  to  the
      end of the string before it is written to the file. Lines  of  text
      written using fwriteline() are compatible for  reading  by  any  of
      the line reading functions if the newline terminator  is  specified
      as an ascii value of 10 (line feed).

      If the line of text is successfully written, TRUE is returned.

      If an error occurs while writing, FALSE is  returned  and  ferror()
      is set to the error value that DOS reported.

      If FALSE is returned but ferror() contains zero, not all the  bytes
      necessary to complete writing <str> to the file were written.  Most
      likely the disk became full while writing.


 Name:    stdout()
 Usage:   stdout(str) -> NIL


 Params:  string str       - A character string to write to the standard
                             output device.

 Returns:

      Nothing

 Description:

      stdout() writes a character string to the  standard  output  device
      which is usually the CONsole. If the program using stdout() is  run
      using the DOS  >  pipe  command  the  output  of  stdout()  can  be
      redirected to a different device.

      The character string to write is specified via the parameter <str>.

      stdout() stops writing the character string as  soon  as  the  null
      terminator of <str> is reached.


 Name:    stdoutline()
 Usage:   stdoutline(str)


 Params:  string str       - A character string to write to the standard
                             output device.

 Returns:

      Nothing

 Description:

      stdoutline() writes a  null  terminated  character  string  plus  a
      carriage return and line feed to the standard output  device  which
      is usually the CONsole. If the program using  stdoutline()  is  run
      using the DOS > pipe command the  output  of  stdoutline()  can  be
      redirected to a different device.

      The character string to write is specified via the parameter <str>.

      stdoutline() stops writing the character string as soon as the null
      terminator of <str>  is  reached.  After  the  null  terminator  is
      reached a final carriage return and line feed pair is output.
