Changeset 11836 in vbox for trunk/include/iprt/path.h

Timestamp:

Aug 29, 2008 4:52:20 PM (16 years ago)

Author:

vboxsync

Message:

IPRT: Implemented RTR3Init*WithProgramPath. Added RTPathParse. Cleaned up the RTPathProgram and RTProcGetExecutableName implementations.

File:

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

trunk/include/iprt/path.h

@@ -231 +231 @@
  */
 RTDECL(void) RTPathStripTrailingSlash(char *pszPath);
+
+/**
+ * Parses a path.
+ * 
+ * It figures the length of the directory component, the offset of 
+ * the file name and the location of the suffix dot.
+ *
+ * @returns The path length.
+ * 
+ * @param   pszPath     Path to find filename in.
+ * @param   pcbDir      Where to put the length of the directory component.
+ *                      If no directory, this will be 0. Optional.
+ * @param   poffName    Where to store the filename offset.
+ *                      If empty string or if it's ending with a slash this
+ *                      will be set to -1. Optional.
+ * @param   poffSuff    Where to store the suffix offset (the last dot).
+ *                      If empty string or if it's ending with a slash this
+ *                      will be set to -1. Optional.
+ * @param   pfFlags     Where to set flags returning more information about 
+ *                      the path. For the future. Optional.
+ */
+RTDECL(size_t) RTPathParse(const char *pszPath, size_t *pcchDir, ssize_t *poffName, ssize_t *poffSuff);
 
 /**