---
url: >-
  /statelake/scripting-reference/functions-and-procedures/conversion-functions/booltostr.md
---

# BoolToStr

**BoolToStr** converts a boolean value into a string, using the following grid.

Depending on whether you specify **UseBoolStrs** to be **True** or **False**, will determine the string result that is returned - either **True** or **False**, or a string consisting of the numeric values minus one (-1), or zero (**0**).

| Result of Input String B | Value of UseBoolStrs | Value of Returned String |
|---|---|---|
| True | False | Minus one ‘-1’. |
| True | False | Zero '0'. |
| False | True | ‘True’. |
| False | True | ‘False’. |

Please also refer to [BooltoFloString](/statelake/scripting-reference/functions-and-procedures/conversion-functions/booltoflostring) for detail about this similar function.

**Declaration**: Function BoolToStr(B: boolean; UseBoolStrs: boolean): string;

Several examples to illustrate the returned values are detailed below.

```pascal
procedure ScriptEvent(var Value:Variant);
var
  TheText, FullText, Which, Which2 : string;
  BoYN : boolean;
begin
  FullText := 'Jack and Jill went up the hill to fetch a pail of water.';

  TheText := 'Jack and Jill';
  BoYN := StartsStr(TheText, FullText);

 //Using 'true' as the UseBoolStrs value means that either 'True' or 'False' will be returned
  Which := BoolToStr(BoYN, true);
  Loginfo('This is TRUE.  This should return TRUE . . . '+Which);

 //Using 'false' as the UseBoolStrs value means that either '-1' or '0' will be returned
  Which := BoolToStr(BoYN, false);
  Loginfo('This is TRUE.  This should return -1 . . . '+Which);

  LogInfo('');
  TheText := 'John and Betty';
  BoYN := StartsStr(TheText, FullText);

 //Using 'true' as the UseBoolStrs value means that either 'True' or 'False' will be returned
  Which2 := BoolToStr(BoYN, true);
  LogInfo('This is FALSE.  This should return FALSE . . . '+Which2);

 //Using 'false' as the UseBoolStrs value means that either '-1' or '0' will be returned
  Which2 := BoolToStr(BoYN, false);
  LogInfo('This is FALSE.  This should return 0 . . . '+Which2);

end;
```