Что означает атрибут [Flags] для перечислений (enum) в C#?

Что делает атрибут [Flags]?

Атрибут [Flags] не меняет поведение компилятора на уровне хранения данных. Он просто подсказывает среде разработки (IDE) и методам форматирования (например, ToString()), что это перечисление предназначено для работы с битовыми флагами. Без [Flags] ваш код всё равно скомпилируется и будет работать, но строковое представление комбинации будет выглядеть как число, а не как набор имён.

Почему степени двойки?

Каждое значение в [Flags] enum должно соответствовать одному биту в двоичном представлении числа. Степени двойки (1, 2, 4, 8, 16...) гарантируют, что при комбинировании через оператор | (побитовое ИЛИ) значения не будут перекрываться. Если вы укажете, например, Monday = 3, то при комбинировании с Tuesday = 2 вы не сможете различить, есть ли Monday или нет.

Как комбинировать и проверять?

Для комбинирования используется побитовое ИЛИ (|), а для проверки — побитовое И (&). Вот полный пример:

[Flags]
public enum Days
{
    None = 0,
    Monday = 1,
    Tuesday = 2,
    Wednesday = 4,
    Thursday = 8,
    Friday = 16,
    Saturday = 32,
    Sunday = 64
}

class Program
{
    static void Main()
    {
        // Комбинируем выходные: суббота + воскресенье
        Days weekend = Days.Saturday | Days.Sunday;
        Console.WriteLine(weekend); // Выведет: "Saturday, Sunday" (благодаря [Flags])

        // Проверяем, есть ли суббота в weekend
        if ((weekend & Days.Saturday) == Days.Saturday)
        {
            Console.WriteLine("Суббота есть!");
        }

        // Проверяем, есть ли понедельник
        if ((weekend & Days.Monday) == Days.Monday)
        {
            Console.WriteLine("Понедельник есть!");
        }
        else
        {
            Console.WriteLine("Понедельника нет.");
        }

        // Добавляем понедельник к weekend
        weekend |= Days.Monday;
        Console.WriteLine(weekend); // "Monday, Saturday, Sunday"

        // Удаляем воскресенье
        weekend &= ~Days.Sunday;
        Console.WriteLine(weekend); // "Monday, Saturday"
    }
}

Важные моменты

• Значение 0 (обычно None) — это особый случай. Оно означает "ни один флаг не установлен".
• Метод HasFlag() — это более читаемая альтернатива побитовой проверке: weekend.HasFlag(Days.Saturday).
• Комбинированные значения — вы можете заранее определить часто используемые комбинации, например: Weekend = Saturday | Sunday.
• Максимум — для int можно использовать до 32 флагов (степени двойки от 2^0 до 2^30). Если нужно больше, используйте long (до 64 флагов).

Итог: [Flags] — это "декоративный" атрибут, который делает работу с битовыми масками удобнее. Но правильные значения (степени двойки) — это ваша ответственность.

Days weekend = Days.Saturday | Days.Sunday;

if (weekend.HasFlag(Days.Saturday))
    Console.WriteLine("Есть суббота");

public static bool IsValidFlags<T>(T value) where T : Enum
{
    // Проверяем, что value не содержит битов, не определённых в enum
    long intValue = Convert.ToInt64(value);
    long allValues = 0;
    foreach (T v in Enum.GetValues(typeof(T)))
    {
        allValues |= Convert.ToInt64(v);
    }
    return (intValue & ~allValues) == 0;
}

// Использование
Days test = (Days)7; // 7 = 1+2+4 (Monday, Tuesday, Wednesday) — корректно
Console.WriteLine(IsValidFlags(test)); // True

Days invalid = (Days)3; // 3 = 1+2, но 3 не определено как отдельное значение
// Однако 3 = Monday | Tuesday, так что это валидно для флагов