Click above to get retro games delivered to your door ever month!

  Sx_FNameParser():

  Syntax:  Sx_FNameParser(cFname [, lPath [, lExt]])

           cFname = A file name
           lPath  = Logical value - .T. if path should be included
           lExt   = Logical value - .T. if file extension should be
                     included

  Returns:   <char> File name with or without path and extension.

  Description:    This is a utility function that takes a file name and
                  returns either the base file name, file name with file
                  extension, file name with path, or file name with path
                  and file extension.  The file name is also converted to
                  upper-case.

                  The main use for this function is to trim either the
                  path or file extension (or both) off a file name.  Note
                  that this function will not add items that are not
                  included in the supplied file name.

                  The default values for lPath and lExt is FALSE (.F.).

  Example:

    ? Sx_FNameParser( "C:\DATA\TEMP.DBF" )            // "TEMP"
    ? Sx_FNameParser( "C:\DATA\TEMP.DBF", .F., .F. )  // "TEMP"
    ? Sx_FNameParser( "C:\DATA\TEMP.DBF", .F., .T. )  // "TEMP.DBF"
    ? Sx_FNameParser( "C:\DATA\TEMP.DBF", .T., .F. )  // "C:\DATA\TEMP"
    ? Sx_FNameParser( "C:\DATA\TEMP.DBF", .T., .T. )  // "C:\DATA\TEMP.DBF"