Filepath manipulation routines
[Portability layer]

Modules
	File system separators definitions.
Functions
char *	port_filepath_merge (const char *root, const char *trail, apr_pool_t *pool)
	Sticks together filepath parts delimiting them by a platform-specific file separator.
char *	port_filepath_canonical (const char *original, apr_pool_t *pool)
	Provides the canonical form of the specified path.
const char *	port_filepath_basename (const char *filepath)
	Finds short file name in the specified filepath.

---

Function Documentation

char* port_filepath_merge	(	const char *	root,
		const char *	trail,
		apr_pool_t *	pool
	)

Sticks together filepath parts delimiting them by a platform-specific file separator.

A typical example is obtaining a path to file by the directory path and the file name.

Parameters:

	root	- the beginning of the file path
	trail	- the ending of the file path

Returns:

The resulting filepath.

char* port_filepath_canonical	(	const char *	original,
		apr_pool_t *	pool
	)

Provides the canonical form of the specified path.

This means that the function returns the standardized absolute path to a resource that can be addressed via different file paths. The canonical form is reasonable to use as a resource identifier.

Note:

The canonical form cannot be guaranteed to be the only unique name due to various file systems specifics.

Parameters:

	original	- the path to be canonicalized
	pool	- the pool to allocate return buffer

Returns:

The canonical name of the specified path.

const char* port_filepath_basename

(

const char *

filepath

)

Finds short file name in the specified filepath.

Returns the pointer to short file name in the source string. If source filepath contains no path separators, returns filepath pointer itself.

Parameters:

root

- the beginning of the file path

Returns:

The pointer to short file name.

---