Csng

Home › Converting Data Types › CSng

CSng

Converts a number or string to a Single.

Syntax

Declare Function CSng ( ByVal expression As datatype ) As Single
Type typename
Declare Operator Cast ( ) As Single
End Type

Parameters

• expression
• datatype
• typename

Description

The CSng function returns a 32-bit Single value. The function does not check for an overflow, so be sure not to pass a value outside the representable range of the Single data type. The name can be explained as 'Convert to SiNGle'.

If the argument to CSng is a string expression, it is first converted to numeric by using Val.

Return Value

A Single precision value.

Remarks

Usage

result = CSng( numeric expression )

result = CSng( string expression )

result = CSng( user defined type )

Differences from QB

• The string argument was not allowed in QB

See also

• CByte
• CUByte
• CShort
• CUShort
• CInt
• CUInt
• CLng
• CULng
• CLngInt
• CULngInt
• CDbl

Examples

' Using the CSNG function to convert a numeric value

'Create an SINGLE variable

Dim numeric_value As Single

'Convert a numeric value

numeric_value = CSng(-12345.123)

'Print the result, should return -12345.123

Print numeric_value

Sleep

---

Category: Converting Data Types
Kind: function

---

Reproduced from the FreeBASIC Wiki Manual under the GNU Free Documentation License 1.3 — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. Copyright © the FreeBASIC project and wiki contributors. See License.