Add some notes about ByteVector::isNull() and ByteVector::null.

This commit is contained in:
Tsuda Kageyu
2015-11-17 13:06:03 +09:00
parent 6b7a2c4cf7
commit 4bac99e3da
2 changed files with 10 additions and 1 deletions

View File

@ -261,7 +261,9 @@ namespace TagLib {
/*!
* Returns true if the vector is null.
*
* \note A vector may be empty without being null.
* \note A vector may be empty without being null. So do not use this
* method to check if the vector is empty.
*
* \see isEmpty()
*/
bool isNull() const;
@ -565,6 +567,9 @@ namespace TagLib {
/*!
* A static, empty ByteVector which is convenient and fast (since returning
* an empty or "null" value does not require instantiating a new ByteVector).
*
* \warning Do not modify this variable. It will mess up the internal state
* of TagLib.
*/
static ByteVector null;

View File

@ -124,6 +124,10 @@ public:
CPPUNIT_ASSERT(i.containsAt(j, 5, 0));
CPPUNIT_ASSERT(i.containsAt(j, 6, 1));
CPPUNIT_ASSERT(i.containsAt(j, 6, 1, 3));
i.clear();
CPPUNIT_ASSERT(i.isEmpty());
CPPUNIT_ASSERT(!i.isNull());
}
void testFind1()