CUINT

• Source: https://www.freebasic.net/wiki/wikka.php?wakka=KeyPgCuint
• Last revised: 2016-03-12

---

Converts numeric or string expression to a Uinteger or Uinteger<bits>

Syntax

declare function Cuint ( byval expression as datatype ) as uinteger
declare function Cuint`<bits>` ( byval expression as datatype ) as uinteger`<bits>`

Type typename

declare operator cast ( ) as uinteger
declare operator cast ( ) as uinteger`<bits>`

End Type

Usage

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

Parameters

bits

A numeric constant expression indicating the size in bits of unsigned integer desired. The values allowed are 8, 16, 32 or 64.

expression

a numeric, string, or pointer expression to cast to a Uinteger or Uinteger<bits> value

datatype

any numeric, string, or pointer data type

typename

a user defined type

Return Value

A Uinteger or Uinteger<bits> containing the converted value.

Description

The Cuint function rounds off the decimal part and returns a Uinteger value, or if a bits value is supplied, an unsigned integer type of the given size.

The function does not check for an overflow; for example, for a 32-bit Uinteger results are undefined for values which are less than 0 or larger than 4 294 967 296.

The name can be explained as 'Convert to Unsigned INTeger'.

If the argument is a string expression, it is converted to numeric by using Valuint or Valulng, depending on the size of the result type.

Examples

start GeSHi

' Using the CUINT function to convert a numeric value

'Create an UNSIGNED INTEGER variable
Dim numeric_value As UInteger

'Convert a numeric value
numeric_value = CUInt(300.23)

'Print the result = 300
Print numeric_value

end GeSHi

Dialect Differences

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

Differences from QB

• New to FreeBASIC

See also

• Cbyte
• Cubyte
• Cshort
• Cushort
• Cint
• Clng
• Culng
• Clngint
• Culngint
• Csng
• Cdbl
• Uinteger

Back to DocToc