System.SysUtils.TryStrToBool

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function TryStrToBool(const S: string; out Value: Boolean): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryStrToBool(const System::UnicodeString S, /* out */ bool &Value)/* overload */;

プロパティ

種類 可視性 ソース ユニット
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

説明

Boolean 成功コードとあわせて、文字列を Boolean(論理)値に変換します。

TryStrToBool は、S で指定された文字列を Boolean に変換し、結果に Value を設定します。S が数値に変換される場合、その数値が 0 ならば、TryStrToBool は Value に false を設定し、0 以外ならば true を設定します。S を数値に変換できない場合、S が TrueBoolStrs にリストされた文字列のいずれか(または大文字小文字が異なるだけの違い)であれば TryStrToBool は true を返し、FalseBoolStrs にリストされた文字列のいずれか(またはまたは大文字小文字が異なるだけの違い)であれば false を返します。S が数値ではなく、かつ、TrueBoolStrsFalseBoolStrs にリストされた文字列のいずれでもない場合、TryStrToBool は false を返して、変換失敗を示します。変換が成功すると、TryStrToBool は true を返します。

メモ:  TrueBoolStrs に値を割り当てていないと、文字列 'True' が 1 つ入っているものとして扱われます。同じく、FalseBoolStrs に値を割り当てていないと、文字列 'False' が 1 つ入っているものとして扱われます。

メモ:  変数 TrueBoolStrsFalseBoolStrs は、アプリケーションの開始時には定義されていません。StrToBoolBoolToStr または TryStrToBool をどのように使用する場合でも、上記のデフォルト値に初期化されます。

関連項目