With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

No credit card required

CLng Function

Syntax

`CLng(`expression`)`
`expression`

Use: Required

Data Type: Numeric or String

The range of `expression` is -2,147,483,648 to 2,147,483,647; fractions are rounded.

Return Value

`expression` cast as a type of Long.

Description

Converts `expression` to a type of Long; any fractional element of `expression` is rounded.

Rules at a Glance

• `expression` must evaluate to a numeric value; otherwise, a type mismatch error is generated.

• If the value of `expression` is outside the range of the long data type, an overflow error is generated.

• When the fractional part is exactly 0.5, CLng always rounds it to the nearest even number. For example, 0.5 rounds to 0, and 1.5 rounds to 2.

Example

```<HTML>
<SCRIPT LANGUAGE="VBScript">
Option Explicit

Dim lSum, sNum1, sNum2

If IsNumeric(sNum1) And IsNumeric(sNum2) Then
lSum = CLng(sNum1) + CLng(sNum2)
Alert "The sum is: " & lSum
Else
Alert "The values you enter in the text boxes must be numeric."
End If
End Sub
</SCRIPT>

<BODY>
<INPUT TYPE="text" NAME="txtText1"><BR>
<INPUT TYPE="text" NAME="txtText2"><BR>
• Use IsNumeric to test whether `expression` evaluates to a number.