diff options
author | Mitch Curtis <mitch.curtis@qt.io> | 2020-02-19 11:29:37 +0100 |
---|---|---|
committer | Mitch Curtis <mitch.curtis@qt.io> | 2020-02-22 14:16:59 +0100 |
commit | 658b9697f9d85d4ed294810b4f60bafdbdd8e247 (patch) | |
tree | d836620dc3d444b0ae6877a278bb78af814d64c6 /src/corelib/doc/src/includes | |
parent | 8471a422e3b4514904ce904aa5aadfab679b4190 (diff) |
Add QDebug::toString()
This template function streams the given object into a QDebug instance
that operates on a string, and then returns that string.
This function is useful for cases where you need the textual
representation of an object for debugging, but cannot use operator<<.
A good example of this is when writing tests where you want to provide
a useful failure message involving details about an object, but must
provide it in a string to e.g. QVERIFY2.
[ChangeLog][QtCore][QDebug] Added static template toString() function,
which streams the given object into a QDebug instance that operates on
a string, and then returns that string.
Fixes: QTBUG-82309
Change-Id: I8411394e899dedad19cec788d779a4515d52ba11
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Diffstat (limited to 'src/corelib/doc/src/includes')
-rw-r--r-- | src/corelib/doc/src/includes/qdebug-toString.qdocinc | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/src/corelib/doc/src/includes/qdebug-toString.qdocinc b/src/corelib/doc/src/includes/qdebug-toString.qdocinc new file mode 100644 index 0000000000..4602a10511 --- /dev/null +++ b/src/corelib/doc/src/includes/qdebug-toString.qdocinc @@ -0,0 +1,7 @@ +Streams \a object into a QDebug instance that operates on a string, +and then returns that string. + +This function is useful for cases where you need the textual representation +of an object for debugging, but cannot use \c {operator<<}. For example: + +\snippet code/src_corelib_io_qdebug.cpp toString |