CULngfunction

Converts numeric or string expression to ULong

Syntax

Declare Function CULng ( ByVal expression As datatype ) As ULong

Type typename

Declare Operator Cast ( ) As ULong

End Type

Parameters

Name		Description
`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.

Remarks

Usage



result = CULng( numeric expression )

result = CULng( string expression )

result = CULng( user defined type )

Dialect Differences

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

Differences from QB

New to FreeBASIC

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

Reference

Documented in KeyPgCulng.html