Chapter 7 File Manager Functions

and returns the value. If p is a path, the existing path is set to the canonical invalid path, and the new p is returned.

returns	The resulting path. If p was not NULL, the return value is the same canonical
	invalid path as p. If an error occurs, NULL is returned.

FRelPath

syntax MgErr FRelPath(startPath, endPath, relPath);

FRelPath computes a relative path between two absolute paths.

Note: You can pass in the same path variable for the new path that you use for the startPath or relPath. Thus, the following three variations for calling this function work.

FRelPath(startPath, endPath, relPath);

/* the relative path is returned in a third path variable */ FRelPath(startPath, endPath, startPath);

/* the new path writes over the old startPath */ FRelPath(startPath, endPath, endPath);

/* the new path writes over the old endPath */

	Parameter	Type	Description
	startPath	Path	Absolute path from which you want the relative path
			to be computed.
	endPath	Path	Absolute path to which you want the relative path to
			be computed.
	relPath	Path	Path returned by fAddPath.
returns		MgErr, which can contain the errors in the following list.
	Error	Description
	mgArgErr	A bad argument was passed to the function. Verify path.
	mFullErr	Insufficient memory.

LabVIEW Code Interface Reference Manual

7-26

National Instruments Corporation