Zen API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kStatus kPath_ToCanonical ( const kChar path,
kChar normalized,
kSize  capacity 
)

Transforms all path separators to normal form, canonicalizes the path by collapsing redundant separators and removes trailing slashes.

In this process, the '.' and '..' components of the path are eliminated/substituted.

The normalized (output) argument can refer to the same memory address as the path (input) argument.

NOTE: Double leading path separators will be retained to support UNC paths and Windows long paths.

Parameters
pathInput path, in native or mixed form.
normalizedReceives transformed path, in normal form.
capacityMaximum number of characters (including null terminator) for normalized path.
Returns
Operation status.