Name
CShort Function
Named Arguments
No
Syntax
CShort(expression
)
-
expression
Use: Required
Data Type: Numeric or String
The range of
expression
is -32,768 to 32,767; fractions are rounded.
Return Value
expression
cast as a Short
Description
Converts expression
to a Short value; any
fractional portion 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 Short data type, an overflow error is generated.When the fractional part of
expression
is exactly .5,CShort
always rounds it to the nearest even number. For example, .5 rounds to 0, and 1.5 rounds to 2.
Example
Dim iMyNumber as Short If IsNumeric(sMyNumber) then iMyNumber = CShort(sMyNumber) End If
Programming Tips and Gotchas
When converting a string representation of a number to a numeric, you should use the data type conversion functions—such as
CShort—
instead ofVal
, because the data type conversion functions take into account the system’s regional settings. In particular,CShort
recognizes the thousands separator if it’s present inexpression
, whereasVal
does not. For example, ifexpression
is 1,234,CShort
successfully converts it to the integer value 1234, whileVal
converts it to 1.Use
IsNumeric
to test whetherexpression
evaluates to a number before performing the conversion.CShort
differs from theFix
andInt
functions, which truncate, rather than round, the fractional part of a number. ...
Get VB .NET Language in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.