Help Center
Help CenterFreeBASIC

CBoolfunction

Converts numeric or string expression to a boolean (Boolean)

Converting Data Typesfunctiondocumented

Syntax

Declare Function CBool ( ByVal expression As datatype ) As Boolean
Type typename
Declare Operator Cast ( ) As Boolean
End Type

Parameters

NameDescription
expressiona numeric, string, or user defined type to cast to a Boolean value
datatypeany numeric, string, or user defined type
typenamea user defined type

Return value


A Boolean value.

Description


The CBool function converts a zero value to False and a non-zero value to True.

The name can be explained as 'Convert to Boolean'.

If the argument is a string expression, it is converted to boolean using a case insensitive to the string "false" to return a False value or "true" to return a True value.

Remarks

Usage


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

Version


  • Since fbc 1.04.0

Dialect Differences


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

Differences from QB


  • New to FreeBASIC

See also


Example


' Using the CBOOL function to convert a numeric value



'Create an BOOLEAN variable

Dim b As Boolean



'Convert a numeric value

b = CBool(1)



'Print the result, should return True

Print b

Sleep


Reference

  • Documented in KeyPgCbool.html