Changeset 80793 in vbox for trunk/include/VBox/com

Timestamp:

Sep 15, 2019 11:27:47 AM (6 years ago)

Author:

vboxsync

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

133360

Message:

Bstr: Added printf, printfNoThrow, printfV and printfVNoThrow methods (untested).

File:

• trunk/include/VBox/com/string.h (modified) (6 diffs)

trunk/include/VBox/com/string.h

@@ -147 +147 @@
     }
 
-    Bstr& operator=(const Bstr &that)
+    Bstr &operator=(const Bstr &that)
     {
         cleanup();
@@ -154 +154 @@
     }
 
-    Bstr& operator=(CBSTR that)
+    Bstr &operator=(CBSTR that)
     {
         cleanup();
@@ -162 +162 @@
 
 #if defined(VBOX_WITH_XPCOM)
-    Bstr& operator=(const wchar_t *that)
+    Bstr &operator=(const wchar_t *that)
     {
         cleanup();
@@ -170 +170 @@
 #endif
 
-    Bstr& setNull()
+    Bstr &setNull()
     {
         cleanup();
@@ -301 +301 @@
     size_t length() const { return isEmpty() ? 0 : ::RTUtf16Len((PRTUTF16)m_bstr); }
 
+    /**
+     * Assigns the output of the string format operation (RTStrPrintf).
+     *
+     * @param   pszFormat       Pointer to the format string,
+     *                          @see pg_rt_str_format.
+     * @param   ...             Ellipsis containing the arguments specified by
+     *                          the format string.
+     *
+     * @throws  std::bad_alloc  On allocation error.  Object state is undefined.
+     *
+     * @returns Reference to the object.
+     */
+    Bstr &printf(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
+
+    /**
+     * Assigns the output of the string format operation (RTStrPrintf).
+     *
+     * @param   pszFormat       Pointer to the format string,
+     *                          @see pg_rt_str_format.
+     * @param   ...             Ellipsis containing the arguments specified by
+     *                          the format string.
+     *
+     * @returns S_OK or E_OUTOFMEMORY
+     */
+    HRESULT printfNoThrow(const char *pszFormat, ...) RT_NOEXCEPT RT_IPRT_FORMAT_ATTR(1, 2);
+
+    /**
+     * Assigns the output of the string format operation (RTStrPrintfV).
+     *
+     * @param   pszFormat       Pointer to the format string,
+     *                          @see pg_rt_str_format.
+     * @param   va              Argument vector containing the arguments
+     *                          specified by the format string.
+     *
+     * @throws  std::bad_alloc  On allocation error.  Object state is undefined.
+     *
+     * @returns Reference to the object.
+     */
+    Bstr &printfV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
+
+    /**
+     * Assigns the output of the string format operation (RTStrPrintfV).
+     *
+     * @param   pszFormat       Pointer to the format string,
+     *                          @see pg_rt_str_format.
+     * @param   va              Argument vector containing the arguments
+     *                          specified by the format string.
+     *
+     * @returns S_OK or E_OUTOFMEMORY
+     */
+    HRESULT printfVNoThrow(const char *pszFormat, va_list va) RT_NOEXCEPT RT_IPRT_FORMAT_ATTR(1, 0);
+
 #if defined(VBOX_WITH_XPCOM)
     /**
@@ -522 +574 @@
      */
     void copyFromN(const char *a_pszSrc, size_t a_cchSrc);
+
+    static DECLCALLBACK(size_t) printfOutputCallbackNoThrow(void *pvArg, const char *pachChars, size_t cbChars) RT_NOEXCEPT;
 
     BSTR m_bstr;