AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

QString: Harmonize the toFloat() and toDouble() documentation

Browse Source 
Both use QLocale::toDouble behind the scenes, so the same limitations
apply. Document them for toFloat() also.

Change-Id: I954362a0db203630685c034df6a921fa6447a509
Reviewed-by: Martin Smith <martin.smith@qt.io>
This commit is contained in:
Andre Hartmann 2018-06-16 20:58:01 +02:00 committed by André Hartmann
parent 67776febd5
commit f731ed9bcf
1 changed files with 13 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
src/corelib/tools/qstring.cpp
View File

@ -7207,21 +7207,30 @@ double QString::toDouble(bool *ok) const
/*!
Returns the string converted to a \c float value.
If a conversion error occurs, *\a{ok} is set to \c false; otherwise
*\a{ok} is set to \c true. Returns 0.0 if the conversion fails.
Returns 0.0 if the conversion fails.
This function ignores leading and trailing whitespace.
If a conversion error occurs, *\a{ok} is set to \c false; otherwise
*\a{ok} is set to \c true.
\warning The QString content may only contain valid numerical characters
which includes the plus/minus sign, the characters g and e used in scientific
notation, and the decimal point. Including the unit or additional characters
leads to a conversion error.
The string conversion will always happen in the 'C' locale. For locale
dependent conversion use QLocale::toFloat()
For historical reasons, this function does not handle
thousands group separators. If you need to convert such numbers,
use QLocale::toFloat().
Example:
\snippet qstring/main.cpp 71
This function ignores leading and trailing whitespace.
\sa number(), toDouble(), toInt(), QLocale::toFloat()
\sa number(), toDouble(), toInt(), QLocale::toFloat(), trimmed()
*/
float QString::toFloat(bool *ok) const