Index: pages/lang.in
==================================================================
--- pages/lang.in
+++ pages/lang.in
@@ -2312,18 +2312,28 @@
^If X is a string then characters indices refer to actual UTF-8
characters. ^If X is a BLOB then the indices refer to bytes.
}
funcdef {tointeger(X)} {} {
- If X is any value (integer, double, or string) that can be losslessly
- converted into an integer, then make the conversion and return the result.
- Otherwise, return NULL.
+ If X is an integer then tointeger(X) returns X.
+ If X is a floating point number or a string that can be losslessly converted
+ into a 64-bit signed integer then tointeger(X) returns that integer.
+ If X is NULL or a BLOB or a floating point number that cannot be represented as a
+ 64-bit signed integer or a string that contains whitespace or a string that
+ does not describe a 64-bit signed integer, then tointeger(X) returns NULL.
}
funcdef {toreal(X)} {} {
- If X can be losslessly converted into a real number, then do so and return
- that real number. Otherwise return NULL.
+ If X is a floating point number then toreal(X) returns X.
+ If X is an integer that can be converted into a 64-bit IEEE-754 floating point
+ number with no loss of precision, then toreal(X) returns that number.
+ If X is a string that describes a floating point number, then toreal(X)
+ returns that number or a close approximation.
+ If X is NULL or a BLOB or an integer that is too large to be losslessly
+ converted into a 64-bit IEEE-754 number or a string that contains whitespace
+ or a string that does not describe a floating point value, then
+ toreal(X) returns NULL.
}
funcdef {total_changes()} {} {
^The total_changes() function returns the number of row changes
caused by INSERT, UPDATE or DELETE