Other Alias
Ns_HomePath, Ns_LibPath, Ns_MakePath, Ns_ModulePath, Ns_NormalizePathSYNOPSIS
#include "ns.h"
char *
Ns_HomePath(Ns_DString *dest, ...)
char *
Ns_LibPath(Ns_DString *dest, ...)
char *
Ns_MakePath(Ns_DString *dest, ...)
char *
Ns_ModulePath(Ns_DString *dest, char *server, char *module, ...)
char *
Ns_NormalizePath(Ns_DString *dsPtr, char *path)
int
Ns_PathIsAbsolute(char *path)
DESCRIPTION
These functions operate on file pathnames. They work with Unix and Windows pathnames on their respective hosts.
- Ns_HomePath(dest, ...)
-
Construct a path name relative to the home directory of the server.
The full path is constructed by appending the library directory
followed by each of the variable number of string elements after
the dest argument. The elements will be separated by a /
character. The list must be terminated with a NULL string.
- Ns_LibPath(dest, ...)
-
Construct a path name relative to the library directory of the
server, normally the lib/ subdirectory of the home directory.
The full path is constructed by appending the library directory
followed by each of the variable number of string elements after
the dest argument. The elements will be separated by a /
character. The list must be terminated with a NULL string.
- Ns_MakePath(dest, ...)
-
Construct a path name from a list of path elements. The Ns_MakePath
function constructs a path name by appending a list of path elements
to the given Ns_DString. The path elements are separated by single
slashes, and the resulting path name is appended to the given
Ns_DString. The last argument needs to be NULL to indicate the end
of the argument list.
- Ns_ModulePath(dest, char *server, char *module, ...)
-
Construct a server and/or module specific pathname relative to the
server home directory. The path in constructed by first appending
the server home directory. Next, if the server argument is
not NULL, "server/serverR" will be appended to the destination
and if the module argument is not NULL, "module/module"
will be appended. Finally, all other string elements, if any, will
be appended to the destination with separating / characters.
The list must be terminated with a NULL string.
- Ns_NormalizePath(dsPtr, path)
-
Normalize a path name. This function removes any extraneous slashes
from the path and resolves "." and ".." references. The result is
appended to the given Ns_DString. The following code appends "/dog"
to the Ns_DString:
-
Ns_NormalizePath(&ds, "/dog/cat/../../rat/../../dog//mouse/..");
-
- Ns_PathIsAbsolute(path)
-
Check for an absolute path name. Return NS_TRUE if the path is
absolute and NS_FALSE otherwise. Under Unix, an absolute path starts
with a "/". On Windows, it starts with a drive letter followed
immediately by a ":".
KEYWORDS