Changeset 39277 in vbox for trunk/include/iprt/cpp

Timestamp:

Nov 11, 2011 4:22:46 PM (13 years ago)

Author:

vboxsync

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

74827

Message:

Runtime: split should really be const; add RTCStringFmt

File:

• trunk/include/iprt/cpp/ministring.h (modified) (2 diffs)

trunk/include/iprt/cpp/ministring.h

@@ -826 +826 @@
      */
     RTCList<RTCString, RTCString *> split(const RTCString &a_rstrSep,
-                                          SplitMode a_enmMode = RemoveEmptyParts);
+                                          SplitMode a_enmMode = RemoveEmptyParts) const;
 
     /**
@@ -953 +953 @@
 RTDECL(const RTCString) operator+(const char *a_psz1, const RTCString &a_rstr2);
 
+/**
+ * Class with RTCString::printf as constructor for your convenience.
+ *
+ * Constructing a RTCString string object from a format string and a variable
+ * number of arguments can easily be confused with the other RTCString
+ * constructors, thus this child class.
+ *
+ * The usage of this class is like the following:
+ * @code
+    RTCStringFmt strName("program name = %s", argv[0]);
+   @endcode
+ */
+class RTCStringFmt : public RTCString
+{
+public:
+
+    /**
+     * Constructs a new string given the format string and the list of the
+     * arguments for the format string.
+     *
+     * @param   a_pszFormat     Pointer to the format string (UTF-8),
+     *                          @see pg_rt_str_format.
+     * @param   ...             Ellipsis containing the arguments specified by
+     *                          the format string.
+     */
+    explicit RTCStringFmt(const char *a_pszFormat, ...)
+    {
+        va_list va;
+        va_start(va, a_pszFormat);
+        printfV(a_pszFormat, va);
+        va_end(va);
+    }
+
+    RTMEMEF_NEW_AND_DELETE_OPERATORS();
+
+protected:
+    RTCStringFmt() {}
+};
+
 /** @} */