Skip to main content

Coldfusion Rounding Functions

Here is some code to show the differences between the various rounding and related function in coldfusion.  The results below are from Coldfusion 10.  I made use of the Rounding Wikipedia article to help explain, in more technical terms, the differences between the functions.






In the results below you can see that we are testing a range of numbers from -2 to 2.  I am calling each function with each of the set of numbers.  For NumberFormat I am using the mask '0' to get the affect of rounding to the decimal place.


Number Round Int Ceiling Fix NumberFormat
-2 -2 -2 -2 -2 -2
-1.9 -2 -2 -1 -1 -2
-1.8 -2 -2 -1 -1 -2
-1.7 -2 -2 -1 -1 -2
-1.6 -2 -2 -1 -1 -2
-1.5 -1 -2 -1 -1 -2
-1.4 -1 -2 -1 -1 -1
-1.3 -1 -2 -1 -1 -1
-1.2 -1 -2 -1 -1 -1
-1.1 -1 -2 -1 -1 -1
-1 -1 -1 -1 -1 -1
-0.9 -1 -1 0 0 -1
-0.8 -1 -1 0 0 -1
-0.7 -1 -1 0 0 -1
-0.6 -1 -1 0 0 -1
-0.5 0 -1 0 0 -1
-0.4 0 -1 0 0 -0
-0.3 0 -1 0 0 -0
-0.2 0 -1 0 0 -0
-0.1 0 -1 0 0 -0
0 0 0 0 0 0
0.1 0 0 1 0 0
0.2 0 0 1 0 0
0.3 0 0 1 0 0
0.4 0 0 1 0 0
0.5 1 0 1 0 1
0.6 1 0 1 0 1
0.7 1 0 1 0 1
0.8 1 0 1 0 1
0.9 1 0 1 0 1
1 1 1 1 1 1
1.1 1 1 2 1 1
1.2 1 1 2 1 1
1.3 1 1 2 1 1
1.4 1 1 2 1 1
1.5 2 1 2 1 2
1.6 2 1 2 1 2
1.7 2 1 2 1 2
1.8 2 1 2 1 2
1.9 2 1 2 1 2
2 2 2 2 2 2

Round

The Round function seems to work as expected, except possibly for the -0.5 and -1.5 values.  These are rounded to 0 and -1 respectively.  The Round function appears to be using the Round Half Up rounding rule.  Up always being in the positive direction.

Int

Int always rounds down to the nearest integer.  This is sometimes known as rounding towards minus infinity.  In other languages this is sometimes called the floor function.  Coldfusion has a Ceiling function, but no floor function.

Ceiling

Ceiling always rounds up to the nearest integer.  This is sometimes known as rounding towards plus infinity.

Fix

Fix drops the numbers after the decimal place.  This gives the same result as rounding towards zero.

NumberFormat

NumberFormat isn't really a rounding function, but it does appear to follow some set of rounding rules when used in the way that I have shown here.  It appears to be producing the same results as rounding half away from zero.  I think what may actually be happening is that it is ignoring the sign and using the same method that the round function uses.

I hope this is helpful information for someone out there.  The Coldfusion documentation was not always clear about what results you should expect when running these functions, so it is nice to have a reference like this.

I have signed up to be able to edit the documentation so I may make some changes there as well.


Comments

Popular posts from this blog

Getting Hidden App Data From Your Google Drive

Some Android applications use space on your Google Drive to store data.  You can't see this data by browsing drive the normal way.  You can get access to it if you get the access token from the app and do a few other things.

I use an app to keep some notes and other things.  They require getting the paid version of the app to backup your data.  I wanted to see if I could get it myself without paying for the app.  I found out how to do this from this Stackoverflow post http://stackoverflow.com/questions/22832104/see-hidden-app-data-in-google-drive.  The example there uses php. Since I have been learning Python recently, I decided to see if I could do the same thing with Python.

 There is a pretty good explanation of why you need to go through all the steps you need to go through to get your data in the accepted answer for that post, so I won't go into too much detail about that here.


My First Memories of Coding

The first time I remember writing code was in grade school in the computer lab.  We were learning Basic.  I'm not sure how old I was, but it would have been sometime in the late '80s or early '90s.  I remember they had us write a program that would take some numbers from the user and print out the average.  I had to ask how to do division. I had only seen it with the standard division symbol in math class, not the forward slash.  Soon after that I was able to get Basic on my home PC.  Actually I think it was included in MS-DOS.

At school and in the beginning at home I was using Basic where you had to use line numbers to write your code.  Then to edit a line you had to retype that line with the number.  Soon after that I was able to get QBasic and a book to help me get started.


Python control of Broadlink RM2 wifi remote

I recently got a Broadlink wifi remote.  I have been playing around trying to send commands to it with python.  I found code on github that does most of what I need.  It looks like the device itself doesn't learn any remote codes.  It is all in the app.  The code I found can send codes to the device and get codes from learning mode. I have a bunch of buttons programmed in the app already.  I wanted to see if I could get those codes.  I think I got them today.  The app, called eControls, allows you to backup your setup.  Today I was able to get my backup file from their backup site. Tomorrow I will try to use the codes from the backup.