System.SysUtils.StrToBool

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function StrToBool(const S: string): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall StrToBool(const System::UnicodeString S)/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Converts a string to a Boolean value.

StrToBool converts the string specified by S to a Boolean. If S can be converted to a number, StrToBool returns False if that number is 0, True otherwise. If S can't be converted to a number, StrToBool returns True if S is any of the strings listed in TrueBoolStrs (or differs from one only by case) and False if it is any of the strings listed in FalseBoolStrs (or differs from one only by case). If S is not a number and not one of the strings listed in TrueBoolStrs or FalseBoolStrs, StrToBool raises an EConvertError exception.

Note: If you do not assign a value to TrueBoolStrs, it is treated as if it contains the single string 'True'. Similarly, if you do not assign a value to FalseBoolStrs, it is treated as if it contains the single string 'False'.

Note: The TrueBoolStrs and FalseBoolStrs variables are undefined when an application starts. Any use of StrToBool, BoolToStr, or TryStrToBool will cause these variables to be initialised with the default values above.

See Also