Changeset 44615 in vbox for trunk/include/iprt

Timestamp:

Feb 10, 2013 6:10:50 PM (12 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

83701

Message:

Runtime/path: Add RTPathCreateRelative to create a relative path between two absolute ones

File:

• trunk/include/iprt/path.h (modified) (1 diff)

trunk/include/iprt/path.h

@@ -594 +594 @@
 
 
+/**
+ * Create a relative path between the two given paths.
+ *
+ * @returns IPRT status code.
+ * @retval  VINF_SUCCESS on success.
+ * @retval  VERR_BUFFER_OVERFLOW if the result is too big to fit within
+ *          cbPathDst bytes.
+ * @retval  VERR_NOT_SUPPORTED if both paths start with different volume specifiers.
+ * @param   pszPathDst      Where to store the resulting path.
+ * @param   cbPathDst       The size of the buffer pszPathDst points to,
+ *                          terminator included.
+ * @param   pszPathFrom     The path to start from creating the relative path.
+ * @param   pszPathTo       The path to reach with the created relative path.
+ */
+RTDECL(int) RTPathCreateRelative(char *pszPathDst, size_t cbPathDst,
+                                 const char *pszPathFrom,
+                                 const char *pszPathTo);
+
 #ifdef IN_RING3