PM_splitpath

Split a full pathname into components.

Declaration

int PMAPI PM_splitpath(
    const char *path,
    char *drive,
    char *dir,
    char *name,
    char *ext)

Prototype In

pmapi.h

Parameters

path

Full path to split

drive

Drive component for path

dir

Directory component for path

name

Filename component for path

ext

Extension component for path

 

Return Value

Flags indicating what components were parsed (PMSplitPathFlags)

Description

Function to split a full pathmame into separate components in the form

X:\DIR\SUBDIR\NAME.EXT

and splits path into its four components. It then stores those components in the strings pointed to by drive, dir, name and ext. (Each component is required but can be a NULL, which means the corresponding component will be parsed but not stored).

The maximum sizes for these strings are given by the constants PM_MAX_DRIVE and PM_MAX_PATH. PM_MAX_DRIVE is always 4, and PM_MAX_PATH is usually at least 256 characters. Under Unix the dir, name and ext components may be up to the full path in length.

See Also

PM_makePath

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com