From abcdc7fd878675bc5efdcfe77ea47eaed8f2531f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C4=99drzej=20Nowacki?= Date: Mon, 24 Sep 2012 15:21:57 +0200 Subject: Make documentation of QVariant::isNull more explicit. Task-number: QTBUG-22933 Change-Id: I1d8d3fc778ba00bcad11caaaf8af7d87186f18e8 Reviewed-by: Jerome Pasion --- src/corelib/kernel/qvariant.cpp | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'src/corelib/kernel') diff --git a/src/corelib/kernel/qvariant.cpp b/src/corelib/kernel/qvariant.cpp index d7969160d3..96f2ff682d 100644 --- a/src/corelib/kernel/qvariant.cpp +++ b/src/corelib/kernel/qvariant.cpp @@ -2808,6 +2808,10 @@ bool QVariant::convert(const int type, void *ptr) const \a v1. See \l{QVariant::}{canConvert()} for a list of possible conversions. + The result of the function is not affected by the result of QVariant::isNull, + which means that two values can be equal even if one of them is null and + another is not. + \warning This function doesn't support custom types registered with qRegisterMetaType(). */ @@ -2902,7 +2906,13 @@ void* QVariant::data() /*! - Returns true if this is a NULL variant, false otherwise. + Returns true if this is a null variant, false otherwise. A variant is + considered null if it contains a default constructed value or a built-in + type instance that has an isNull method, in which case the result + would be the same as calling isNull on the wrapped object. + + \warning The result of the function doesn't affect == operator, which means + that two values can be equal even if one of them is null and another is not. */ bool QVariant::isNull() const { -- cgit v1.2.3