Changeset 36577 in vbox for trunk/include/iprt

Timestamp:

Apr 6, 2011 1:35:17 PM (14 years ago)

Author:

vboxsync

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

71017

Message:

iprt: add RTDirCreateUniqueNumbered

File:

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

trunk/include/iprt/dir.h

@@ -90 +90 @@
  */
 RTDECL(int) RTDirCreateTemp(char *pszTemplate);
+
+/**
+ * Creates a new directory with a unique name by appending a number.
+ *
+ * First it is tried to create the directory without any numbers appended.
+ * When this fails a number string is appended (starting with 1) separated by
+ * the optional separator. The numbers are zero padded.
+ *
+ * On success @a pszPath contains the path created.
+ *
+ * @returns iprt status code.
+ * @param   pszPath     Path to the directory to create.
+ * @param   cbSize      The size of pszPath. Needs enough space for holding the
+ *                      digits and the optional separator.
+ * @param   fMode       The mode of the new directory.
+ * @param   cchDigits   How many digits should the number maximal have.
+ * @param   chSep       The separator used between the path and the number. Can
+ *                      be zero. (optional)
+ */
+RTDECL(int) RTDirCreateUniqueNumbered(char *pszPath, size_t cbSize, RTFMODE fMode, size_t cchDigits, char chSep);
 
 /**