Zen API
|
kStatus kPath_ToRelative | ( | const kChar * | pathA, |
const kChar * | pathB, | ||
kChar * | bRelativeToA, | ||
kSize | capacity | ||
) |
Expresses an absolute path in relative form, in relation to a reference path.
If pathA and pathB are rooted in different volumes, then bRelativeToA will receive an absolute path equal to pathB.
The bRelativeToA (output) argument can refer to the same memory address as either the pathA or pathB (input) arguments.
pathA | Absolute reference path. |
pathB | Absolute path to be re-expressed as relative to path A. |
bRelativeToA | Receives path b, expressed as relative to path A. |
capacity | Maximum number of characters (including null terminator) for the relative path. |