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

fnsplit()                Split a Full Path Name into Its Components

 #include   <dir.h>

 int        fnsplit(path,drive,dir,name,ext);
 char       *path;                       Full name
 char       *drive;                      Drive
 char       *dir;                        Directory/subdirectory
 char       *name;                       File name
 char       *ext;                        File extension

    fnsplit() splits 'path' into its four components.  'path' is a string
    in the form:

                     X:\DIR\SUBDIR\NAME.EXT

    fnsplit() then stores the components in the strings 'drive', 'dir',
    'name', and 'ext'.   The maximum sizes for these strings are given by
    the following constants (defined in <dir.h>):

                MAXPATH       80   path
                MAXDRIVE       3   drive (includes colon)
                MAXDIR        66   dir (includes leading and
                                   trailing backslashes)
                MAXFILE        9   name
                MAXEXT         5   ext (includes leading dot)

    Each size includes space for the null-terminator.  Each component is
    required but can be NULL.  This means the corresponding component
    will be parsed but not stored.  fnsplit() assumes there is enough
    space to store each non-NULL component.

    When fnsplit() splits 'path', it treats the punctuation as follows:

                'drive'       keeps the colon attached (A:)
                'dir'         keeps the leading and trailing
                              backslashes (\turboc\lib\)
                'ext'         keeps the dot preceding the extension (.c)

    Returns:    An integer composed of five flags (defined in <dir.h>)
                indicating which of the path name components were present
                in 'path'.  The flags and the components they represent
                are:

                EXTENSION     an extension
                FILENAME      a filename
                DIRECTORY     a directory (and possibly subdirectories)
                DRIVE         a drive specification
                WILDCARD      wildcards (? or *)