1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clean up docs of qbytearray.cpp's C-string functions

Browse Source 
Details of MSVC version became irrelevant some time ago; the code now
just tests for MSVC. In any case, the reader doesn't need to know how
the function is implemented, as long as it does what it claims to do.

We do not, in fact, use a random number source when generating the
return value for comparisons involving only one nullptr; we quite
consistently treat the nullptr as less than the other string. Make
explicit that this is true even if the other is empty.

Change-Id: Ifd9b00fdf8e814fcf933a05821201670fecfd646
Reviewed-by: Andrei Golubev <andrei.golubev@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
This commit is contained in:
Edward Welbourne 2020-06-04 17:12:55 +02:00
parent 94ad8518e0
commit 5ba44d1427
1 changed files with 12 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/corelib/text/qbytearray.cpp
View File

@ -150,10 +150,6 @@ char *qstrcpy(char *dst, const char *src)
\note If \a dst and \a src overlap, the behavior is undefined.
\note When compiling with Visual C++ compiler version 14.00
(Visual C++ 2005) or later, internally the function strncpy_s
will be used.
\sa qstrcpy()
*/
@ -204,10 +200,9 @@ char *qstrncpy(char *dst, const char *src, uint len)
is less than \a str2, 0 if \a str1 is equal to \a str2 or a
positive value if \a str1 is greater than \a str2.
Special case 1: Returns 0 if \a str1 and \a str2 are both \nullptr.
Special case 2: Returns an arbitrary non-zero value if \a str1 is
\nullptr or \a str2 is \nullptr (but not both).
If both strings are \nullptr, they are deemed equal; otherwise, if either is
\nullptr, it is treated as less than the other (even if the other is an
empty string).
\sa qstrncmp(), qstricmp(), qstrnicmp(), {Character Case}, QByteArray::compare()
*/
@ -229,10 +224,9 @@ int qstrcmp(const char *str1, const char *str2)
str1 is equal to \a str2 or a positive value if \a str1 is greater
than \a str2.
Special case 1: Returns 0 if \a str1 and \a str2 are both \nullptr.
Special case 2: Returns a random non-zero value if \a str1 is \nullptr
or \a str2 is \nullptr (but not both).
If both strings are \nullptr, they are deemed equal; otherwise, if either is
\nullptr, it is treated as less than the other (even if the other is an
empty string or \a len is 0).
\sa qstrcmp(), qstricmp(), qstrnicmp(), {Character Case}, QByteArray::compare()
*/
@ -248,10 +242,9 @@ int qstrcmp(const char *str1, const char *str2)
str1 is equal to \a str2 or a positive value if \a str1 is greater
than \a str2.
Special case 1: Returns 0 if \a str1 and \a str2 are both \nullptr.
Special case 2: Returns a random non-zero value if \a str1 is \nullptr
or \a str2 is \nullptr (but not both).
If both strings are \nullptr, they are deemed equal; otherwise, if either is
\nullptr, it is treated as less than the other (even if the other is an
empty string).
\sa qstrcmp(), qstrncmp(), qstrnicmp(), {Character Case}, QByteArray::compare()
*/
@ -338,10 +331,9 @@ int qstricmp(const char *str1, const char *str2)
is equal to \a str2 or a positive value if \a str1 is greater than \a
str2.
Special case 1: Returns 0 if \a str1 and \a str2 are both \nullptr.
Special case 2: Returns a random non-zero value if \a str1 is \nullptr
or \a str2 is \nullptr (but not both).
If both strings are \nullptr, they are deemed equal; otherwise, if either is
\nullptr, it is treated as less than the other (even if the other is an
empty string or \a len is 0).
\sa qstrcmp(), qstrncmp(), qstricmp(), {Character Case}, QByteArray::compare()
*/