Changeset 49039 in vbox for trunk/include/iprt

Timestamp:

Oct 10, 2013 6:27:32 PM (12 years ago)

Author:

vboxsync

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

89816

Message:

IPRT: Filename extension versus suffix cleanup, long overdue.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (3 diffs)
• path.h (modified) (2 diffs)

trunk/include/iprt/mangling.h

@@ -653 +653 @@
 # define RTLdrRelocate                                  RT_MANGLER(RTLdrRelocate)
 # define RTLdrRvaToSegOffset                            RT_MANGLER(RTLdrRvaToSegOffset)
+# define RTLdrQueryProp                                 RT_MANGLER(RTLdrQueryProp)
 # define RTLdrSegOffsetToRva                            RT_MANGLER(RTLdrSegOffsetToRva)
 # define RTLdrSize                                      RT_MANGLER(RTLdrSize)
@@ -976 +977 @@
 # define RTPathExists                                   RT_MANGLER(RTPathExists)
 # define RTPathExistsEx                                 RT_MANGLER(RTPathExistsEx)
-# define RTPathExt                                      RT_MANGLER(RTPathExt)
+# define RTPathSuffix                                   RT_MANGLER(RTPathSuffix)
 # define RTPathFilename                                 RT_MANGLER(RTPathFilename)
 # define RTPathFilenameEx                               RT_MANGLER(RTPathFilenameEx)
 # define RTPathGetCurrent                               RT_MANGLER(RTPathGetCurrent)
 # define RTPathGetMode                                  RT_MANGLER(RTPathGetMode)
-# define RTPathHasExt                                   RT_MANGLER(RTPathHasExt)
+# define RTPathHasSuffix                                RT_MANGLER(RTPathHasSuffix)
 # define RTPathHasPath                                  RT_MANGLER(RTPathHasPath)
 # define RTPathIsSame                                   RT_MANGLER(RTPathIsSame)
@@ -1009 +1010 @@
 # define RTPathStartsWith                               RT_MANGLER(RTPathStartsWith)
 # define RTPathStartsWithRoot                           RT_MANGLER(RTPathStartsWithRoot)
-# define RTPathStripExt                                 RT_MANGLER(RTPathStripExt)
+# define RTPathStripSuffix                              RT_MANGLER(RTPathStripSuffix)
 # define RTPathStripFilename                            RT_MANGLER(RTPathStripFilename)
 # define RTPathStripTrailingSlash                       RT_MANGLER(RTPathStripTrailingSlash)

trunk/include/iprt/path.h

@@ -316 +316 @@
 
 /**
- * Strips the extension from a path.
- *
- * @param   pszPath     Path which extension should be stripped.
- */
-RTDECL(void) RTPathStripExt(char *pszPath);
+ * Strips the last suffix from a path.
+ *
+ * @param   pszPath     Path which suffix should be stripped.
+ */
+RTDECL(void) RTPathStripSuffix(char *pszPath);
 
 /**
@@ -397 +397 @@
 
 /**
- * Finds the extension part of in a path.
- *
- * @returns Pointer to extension within pszPath.
- * @returns NULL if no extension.
- * @param   pszPath     Path to find extension in.
- */
-RTDECL(char *) RTPathExt(const char *pszPath);
-
-/**
- * Checks if a path has an extension.
- *
- * @returns true if extension present.
- * @returns false if no extension.
+ * Finds the suffix part of in a path (last dot and onwards).
+ *
+ * @returns Pointer to suffix within pszPath.
+ * @returns NULL if no suffix
+ * @param   pszPath     Path to find suffix in.
+ *
+ * @remarks IPRT terminology: A suffix includes the dot, the extension starts
+ *          after the dot. For instance suffix '.txt' and extension 'txt'.
+ */
+RTDECL(char *) RTPathSuffix(const char *pszPath);
+
+/**
+ * Checks if a path has an extension / suffix.
+ *
+ * @returns true if extension / suffix present.
+ * @returns false if no extension / suffix.
  * @param   pszPath     Path to check.
  */
-RTDECL(bool) RTPathHasExt(const char *pszPath);
-/** Misspelled, don't use.  */
-#define RTPathHaveExt   RTPathHasExt
+RTDECL(bool) RTPathHasSuffix(const char *pszPath);
+/** Same thing, different name.  */
+#define RTPathHasExt RTPathHasSuffix
 
 /**