true-Operator (C#-Referenz)

Aktualisiert: Juli 2008

Gibt den booleschen Wert true zurück, um anzugeben, dass ein Operand auf True festgelegt ist, und gibt andernfalls false zurück.

Vor C# 2.0 wurden der true-Operator und der false-Operator zum Erstellen benutzerdefinierter auf NULL festlegbarer Werttypen verwendet, die mit bestimmten Typen kompatibel sind, z. B. SqlBool. Die Programmiersprache bietet nun jedoch integrierte Unterstützung für auf NULL festlegbare Werttypen, und nach Möglichkeit sollten Sie statt der Überladung des true-Operators und des false-Operators diese verwenden. Weitere Informationen finden Sie unter Typen, die NULL-Werte zulassen (C#-Programmierhandbuch).

Bei auf NULL festlegbaren booleschen Werten ist der Ausdruck a != b nicht notwendigerweise gleich !(a == b), da einer der Werte oder beide Werte NULL sein können. Sie müssen den true-Operator und den false-Operator getrennt überladen, um die NULL-Werte im Ausdruck richtig zu bezeichnen. Das folgende Beispiel veranschaulicht die Überladung und Verwendung des true-Operators und des false-Operators.

// For example purposes only. Use the built-in nullable bool 
// type (bool?) whenever possible.
public struct DBBool
{
    // The three possible DBBool values.
    public static readonly DBBool Null = new DBBool(0);
    public static readonly DBBool False = new DBBool(-1);
    public static readonly DBBool True = new DBBool(1);
    // Private field that stores –1, 0, 1 for False, Null, True.
    sbyte value;
    // Private instance constructor. The value parameter must be –1, 0, or 1.
    DBBool(int value)
    {
        this.value = (sbyte)value;
    }
    // Properties to examine the value of a DBBool. Return true if this
    // DBBool has the given value, false otherwise.
    public bool IsNull { get { return value == 0; } }
    public bool IsFalse { get { return value < 0; } }
    public bool IsTrue { get { return value > 0; } }
    // Implicit conversion from bool to DBBool. Maps true to DBBool.True and
    // false to DBBool.False.
    public static implicit operator DBBool(bool x)
    {
        return x ? True : False;
    }
    // Explicit conversion from DBBool to bool. Throws an exception if the
    // given DBBool is Null; otherwise returns true or false.
    public static explicit operator bool(DBBool x)
    {
        if (x.value == 0) throw new InvalidOperationException();
        return x.value > 0;
    }
    // Equality operator. Returns Null if either operand is Null; otherwise
    // returns True or False.
    public static DBBool operator ==(DBBool x, DBBool y)
    {
        if (x.value == 0 || y.value == 0) return Null;
        return x.value == y.value ? True : False;
    }
    // Inequality operator. Returns Null if either operand is Null; otherwise
    // returns True or False.
    public static DBBool operator !=(DBBool x, DBBool y)
    {
        if (x.value == 0 || y.value == 0) return Null;
        return x.value != y.value ? True : False;
    }
    // Logical negation operator. Returns True if the operand is False, Null
    // if the operand is Null, or False if the operand is True.
    public static DBBool operator !(DBBool x)
    {
        return new DBBool(-x.value);
    }
    // Logical AND operator. Returns False if either operand is False,
    // Null if either operand is Null, otherwise True.
    public static DBBool operator &(DBBool x, DBBool y)
    {
        return new DBBool(x.value < y.value ? x.value : y.value);
    }
    // Logical OR operator. Returns True if either operand is True, 
    // Null if either operand is Null, otherwise False.
    public static DBBool operator |(DBBool x, DBBool y)
    {
        return new DBBool(x.value > y.value ? x.value : y.value);
    }
    // Definitely true operator. Returns true if the operand is True, false
    // otherwise.
    public static bool operator true(DBBool x)
    {
        return x.value > 0;
    }
    // Definitely false operator. Returns true if the operand is False, false
    // otherwise.
    public static bool operator false(DBBool x)
    {
        return x.value < 0;
    }
    public override bool Equals(object obj)
    {
        if (!(obj is DBBool)) return false;
        return value == ((DBBool)obj).value;
    }
    public override int GetHashCode()
    {
        return value;
    }
    public override string ToString()
    {
        if (value > 0) return "DBBool.True";
        if (value < 0) return "DBBool.False";
        return "DBBool.Null";
    }
}

Ein Typ, der den true-Operator und den false-Operator überlädt, kann für den steuernden Ausdruck in den Anweisungen if, do, while und for sowie in bedingten Ausdrücken verwendet werden.

Wenn ein Typ den Operator true definiert, muss er auch den Operator false definieren.

Die bedingten logischen Operatoren (&& und ||) können von einem Typ nicht direkt überladen werden. Eine vergleichbare Wirkung kann jedoch erzielt werden durch Überladung der regulären logischen Operatoren und der Operatoren true und false.

C#-Programmiersprachenspezifikation

Weitere Informationen finden Sie in den folgenden Abschnitten von C#-Programmiersprachenspezifikation:

• 7.6 Unäre Operatoren

• 7.11.2 Benutzerdefinierte bedingte logische Operatoren

• 7.19 Boolesche Ausdrücke

Siehe auch

Konzepte

C#-Programmierhandbuch

Referenz

C#-Schlüsselwörter

C#-Operatoren

false (C#-Referenz)

Weitere Ressourcen

C#-Referenz

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
Juli 2008	Informationen zum Überladen des true-Operators und des false-Operators hinzugefügt.	Informationsergänzung.