Validating numeric input

[Home]   [Puzzles & Projects]    [Delphi Techniques]   [Math Topics]   [Library]   [Utilities]

 

Search

 

Search DelphiForFun.org only

Support DFF

 If you shop at Amazon anyway,  consider using this link. We receive a few cents from each purchase.   Thanks.

In Association with Amazon.com

 

Support DFF

 If you benefit from the website,  in terms of knowledge, entertainment value, or something otherwise useful, consider making a donation via PayPal  to help defray the costs.  (No PayPal account necessary to donate via credit card.)  Transaction is secure.

 

 

Contact

Feedback:  Send an e-mail with your comments about this program (or anything else).

 

Search DelphiForFun.org only

 

 

 

 

 

Validating numeric input is a common problem -  you want the user to enter a number but how do you make sure he enters a valid one?  User text is normally entered via a TEdit component.   In the object inspector window (F11) there is an events tab and if you click there one of the events will be "OnKeypress".  Double click there and you get the skeleton of a method that is called whenever the user enters a character in the edit box.  We can use this exit to check that the entered character is valid. 

For integers the valid characters are '0' through '9', '-',  and the backspace character.  ('+' could be included but is always redundant since no sign in front of a number means '+')    Delphi defines this set of 12 characters '0' through '9', '-'  and  backspace  as ['0'..'9','-',#8].  (#8 is the decimal number generated when you press the backspace key.)  If the character entered is not one those, we can set the key value to 0 (which tells windows to ignore this key) and beep to let the user know that something is wrong.   The other test we can perform here is to test that there is no more than one  or  '-'  and that if a '-' is  entered it will go at the beginning. 

To be completely safe, there is one other potential error which OnKeyPress can't catch.  We can use an OnChange exit to detect an empty text string and replace it with a '0'.  

Validating floating point numbers (with decimals) is similar except that we must add '.' to the set of valid characters in OnKeyPress.  For generality we can use the global predefined constant DecimalSeparator in place of '.'. (Europeans exchange the dot and comma from proper usage.)  We need to make sure that there at most only a single  DecimalSeparator in the number.    OnChange coding is unchanged from the integer version. 

A program illustrating these techniques is available for download here.  Notice that the same OnChange exit can handle both the integer and floating point number validation.   Similarly, multiple integer edit fields (or multiple floating point edit fields) could share the same OnKeyPress procedure.  As an added bonus, the program uses a TMediaPlayer component and .wav files to give a little more than the normal beep when an error is made.  

Addendum:  (2/18/2001)  New visual components TIntEdit and TFloatEdit are now available to simplify checking numeric input.  Check it out at the Numeric Edit Component page. 

Addendum July 7, 2010:  This was one of the first programs posted on DFF and , frankly, I had not looked at it in years.  A "KeyPress" exit implements "real time" editing of numbers as they are entered.  In practice, I find that it is adequate most of the time to postpone the validation until the number is needed.   Also, since the above addendum about the numeric edit components was posted, I have abandoned installed user components altogether.   They tended to get lost during every  Delphi version, Windows version, or PC replacement change.  There are better ways to accomplish the same thing by dynamically constructing new controls when they are needed.  See NumEdit2 on the Numeric Edit page for a version the TIntEdit and TFloatEdit that can be built dynamically at runtime

In any event, a viewer wrote recently requesting the ability to validate multiple integers in a single Tedit text string.  Version 2 posted today provides that capability.  It also includes sample code to extract and convert multiple numbers from the string as required.  

Download source code here 

Created: ???, 2000

Modified: July 09, 2010

  [Feedback]   [Newsletters (subscribe/view)] [About me]
Copyright 2000-2014, Gary Darby    All rights reserved.