File Utilities

File and directory management functions.

function chdrivedir
Change current default drive and working directory.

Causes the current default drive and working directory to change to the directory specified by pathname. The pathname must refer to an existing directory.

Returns a value of 0 if the default drive and working directory was successfully changed. A return value of -1 indicates an error.

public int chdrivedir (const char * pathname)
 * Source: pm_fileutils.h:195
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function is_dir
Returns TRUE if the specified location is a directory.

public BOOL is_dir ( const char * location )
 * Source: pm_fileutils.h:169
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function is_file
Returns TRUE if the specified location is a regular file.

public BOOL is_file ( const char * location )
 * Source: pm_fileutils.h:142
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function is_root
Returns TRUE if the specified location is a root directory.

public BOOL is_root ( const char * location )
 * Source: pm_fileutils.h:160
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function is_url
Returns TRUE if the specified location is a URL.

public BOOL is_url ( const char * location )
 * Source: pm_fileutils.h:151
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function scheme
Returns the scheme followed by a colon of the specified location.

Returns an empty string if specified location does not contain definition of the url scheme.

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * scheme (	char * result,                      	const char * location ,                        size_t size )
 * Source: pm_fileutils.h:54
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sdecode
Passed any string value, decode from URL transmission.

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * sdecode (char * result,      	                const char * location ,       	                size_t size )
 * Source: pm_fileutils.h:133
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sdrive
Returns the drive letter followed by a colon if a drive is specified in the location.

Returns an empty string if specified path does not contain definition of the drive.

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * sdrive (	char * result,      	                const char * location ,       	                size_t size )
 * Source: pm_fileutils.h:38
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sdrivedir
Returns the drive letter or scheme and the path of subdirectories, if any, including the trailing slash.

Slashes (/), backslashes (\), or both may be present in location.

Returns an empty string if specified location does not contain any path definition.

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * sdrivedir ( char * result,      	                  const char * location ,       	                  size_t size )
 * Source: pm_fileutils.h:120
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sfext
Returns the file name extension, if any, including the leading period (.).

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * sfext ( char * result,      	              const char * location ,       	              size_t size )
 * Source: pm_fileutils.h:80
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sfextrep
Replaces an extension of the specified file.

The specified extension may include the leading period (.).

public char * sfextrep ( char * filename,      	                 const char * ext ,       	                 int size )
 * Source: pm_fileutils.h:91
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sfname
Returns the base file name without any extensions.

Note: Because the result string always less or is equal to a location string all functions can safely use the same storage area for a location and result.

public char * sfname (	char * result,      	                const char * location ,       	                size_t size )
 * Source: pm_fileutils.h:67
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function sfnameext
Returns the base file name with file extension.

The specified extension must include the leading period (.).

public char * sfnameext ( char * result,     	                  const char * location ,       	                  size_t size )
 * Source: pm_fileutils.h:102
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code:

function smakepath
Creates a single path name, composed of a base path name and file or directory name.

public char *smakepath (char *result,      	                 const char *pathname,       	                 const char *name,       	                 int size)
 * Source: pm_fileutils.h:179
 * Author: Dmitry A.Steklenev
 * Version: 1.0
 * Code: