CULng

FreeBASIC

CULng
 
Converts numeric or string expression to Ulong

Syntax

Declare Function CULng ( ByVal expression As datatype ) As Ulong

Type typename
End Type

Usage

result = CULng( numeric expression )
result = CULng( string expression )
result = CULng( user defined type )

Parameters

expression
a numeric, string, or pointer expression to cast to a Ulong value
datatype
any numeric, string, or pointer data type
typename
a user defined type

Return Value

A Ulong value.

Description

The CULng function rounds off the decimal part and returns a 32 bit Ulong value. The function does not check for an overflow. The name can be explained as 'Convert to Unsigned LoNG'.

If the argument is a string expression, it is converted to numeric by using ValUInt or ValULng.

Example

' Using the CULNG function to convert a numeric value

'Create an UNSIGNED LONG variable
Dim numeric_value As ULONG

'Convert a numeric value
numeric_value = CULng(300.23)

'Print the result = 300
Print numeric_value
Sleep


Dialect Differences

  • Not available in the -lang qb dialect unless referenced with the alias __Culng.

Differences from QB

  • New to FreeBASIC

See also