qc.hlp (Table of Contents; Topic list)
_makepath
 Summary Example                         Up Contents Index Back
────────────────────────────────────────────────────────────────────────────
 
     The _makepath routine creates a single path name, composed of a
     drive letter, directory path, file name, and file-name 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 argument contains the path of directories, not
                 including the drive designator or the actual file
                 name. The trailing slash is optional. Forward slashes
                 (/), backslashes (\), or both may 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 file name
                 without any extensions. If <fname> is NULL or points
                 to an empty string, no file name is inserted in the
                 composite <path> string.
 
     <ext>       The <ext> argument contains the actual file-name
                 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 any of the
     current versions of DOS or OS/2 will handle.
 
     Return Value
 
     None.
                                    -♦-