Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _makepath routine creates a single path name, composed of a
     drive letter, directory path, filename, and filename extension.
 
     The <path> argument should point to an empty buffer large enough
     to hold the complete path name. The constant _MAX_PATH (defined in
     STDLIB.H) specifies the maximum size <path> that the operating
     system can handle. The other arguments point to the following
     buffers containing the path-name elements:
 
     Buffer      Description
 
     <drive>     The <drive> argument contains a letter (A, B, etc.)
                 corresponding to the desired drive and an optional
                 trailing colon. The _makepath routine inserts the
                 colon automatically in the composite path name if it
                 is missing. If <drive> is a null character or an empty
                 string, no drive letter and colon will appear in the
                 composite <path> string.
 
     <dir>       The <dir> argument contains the path of directories,
                 not including the drive designator or the actual
                 filename. The trailing slash is optional. Forward
                 slashes (/), backslashes (\), or both can be used in
                 a single <dir> argument. If a trailing slash or
                 backslash (/ or \) is not specified, it will be
                 inserted automatically. If <dir> is a null character
                 or an empty string, no slash is inserted in the
                 composite <path> string.
 
     <fname>     The <fname> argument contains the base filename
                 without any extensions. If <fname> is NULL or points
                 to an empty string, no filename is inserted in the
                 composite <path> string.
 
     <ext>       The <ext> argument contains the actual filename
                 extension, with or without a leading period (.). The
                 _makepath routine inserts the period automatically if
                 it does not appear in <ext>. If <ext> is a null
                 character or an empty string, no period is inserted in
                 the composite <path> string.
 
     There are no size limits on any of the above four fields.
     However, the composite path should be no larger than the _MAX_PATH
     constant. The limit _MAX_PATH is much larger than current
     operating-system versions will handle.
 
     Return Value
 
     None.
                                    -♦-