LiveDocs Comments - coldfusion - 6.1 - htmldocs - funct121.htm

coldfusion/6.1/htmldocs/funct121.htm

s_bywater — 2005-06-30T14:11:45

This is pedantic, but it should be "Calculates the closest integer that is smaller than or equal to number." Int(3) = 3, not 2. :)

coldfusion/6.1/htmldocs/funct121.htm

halL — 2004-04-02T07:36:33

I should also have noted with respect to numbers that are too large to be represented internally as numeric integers, In ColdFusion MX 6.1, the Int function returns a value, but it can be invalid. For example the following code has numbers consisting of 13 digit 9s, which ColdFusion can represent internally as a string or convert to a real number, but cannot represent internally as a numeric integer:

9999999999999: #int(9999999999999)#

-9999999999999: #int(-9999999999999)#

This code displays:
9999999999999: 1E+013
-9999999999999: -1E+013
Which means that ColdFusion actually rounded up by one!
This behavior is consistent with ColdFusion 5.0 behavior.

coldfusion/6.1/htmldocs/funct121.htm

halL — 2004-04-02T07:21:03

As indicated in the Oct 2, 2003 comment, this function is really a floor function.
It returns the largest integer that is smaller than the parameter.
Therefore it returns 3 for 3.3 or 3.7 and -4 for -3.3 and -3.7
Future versions of this page will state this clearly.

coldfusion/6.1/htmldocs/funct121.htm

Adam Cameron — 2004-04-01T16:50:40

Note: this function's handling of negative numbers is incorrect. It should return the integer portion of the number (simply casting it as either an INT or a LONG as appropriate), and that is all.
The integer portion of -3.7 is -3, not -4.

coldfusion/6.1/htmldocs/funct121.htm

PsG-1b — 2003-12-15T16:08:59

Responding to DracTK,

I tried int(gettickcount()) and as far as I can tell it's working properly. The number returned by gettickcount() is an integer already, "integer" meaning mathematical integer. As far as the integer data type, that is only 4 bytes, or 32 bits, and we all know the biggest signed number that can be represented in 4 bytes is 2^32-1, or 4294967295. gettickcount() returned something two orders of magnitude higher than this number. And the int() function still works as intended because it turns that large number into a data-type akin to floating point. So it's still a mathematical integer, but just represented differently. (100 is an integer, and I would *think* that 1e2, 1.0e2, and 1.000000e2 are all integers as well since they mean the same thing)

coldfusion/6.1/htmldocs/funct121.htm

2003-10-02T13:12:04

This function is more accurately the Floor() function rather than the Int() function. So, for example, Int(2.5) = 2.0 and not 2. This is an important distinction if you want to use this number to index an array or query as an attempt to do so throws an exception.

coldfusion/6.1/htmldocs/funct121.htm

DracTK — 2003-08-13T08:35:40

This function description is misleading, it doesn't convert ALL numbers to the first smallest int. It only converts numbers when the function argument is within the range of allowed integers. For example try this int(GetTickCount()). Int should convert very large number that getTickCount() produces to integer, but it does not. I suggest that either the description of this function be changed or this function's behavior be modified to fit its description.