Visual Basic 2005 in a Nutshell (In a Nutshell (OReilly))

CShort Function

Syntax

Dim result As Short = CShort(expression)

expression (required; Numeric or String)

Any expression in the valid range of the Short data type

Description

The CShort function converts expression to the Short data type; any fractional portion of expression is rounded.

Usage at a Glance

  • An expression that evaluates outside the valid range of the target data type results in a runtime error. Nonnumeric expressions also generate an error.

  • In most cases, the numeric conversion functions are a better choice than the Val function when converting a string, as the conversion functions take into account the system's regional settings. However, Val converts empty strings to zero without error.

  • Use IsNumeric to test whether expression evaluates to a number.

  • This function does not support named arguments.

  • CShort differs from the Fix and Int functions, which truncate, rather than round, the fractional part of a number. Also, Fix and Int always return the same data type as what was passed in.

Example

Dim targetNumber As Short If IsNumeric(stringNumber) Then targetNumber = CShort(stringNumber) End If

Version Differences

The CShort function is new to VB under .NET. However, it corresponds directly to the VB 6 CInt function, since both return 16-bit integers.

See Also

CInt Function, CLng Function, CUShort Function

Категории