Чи повинен Enum починати з 0 або 1?

Уявіть, що я визначив наступного Enum:

public enum Status : byte
{
    Inactive = 1,
    Active = 2,
}

Яка найкраща практика використовувати enum? Чи слід починати з 1подібного прикладу чи починати з 0(без явних значень) так:

public enum Status : byte
{
    Inactive,
    Active
}

Рамкові рекомендації щодо дизайну :

✔️ DO забезпечити значення нуля на простих перерахунках.

Подумайте, як називати значення чимось на зразок "None". Якщо таке значення не підходить для цього конкретного перерахунку, найпоширенішому за замовчуванням для enum слід призначити базове значення нульове.

Рамкові керівні принципи / Проектування прапорців :

❌ Уникнути використання нульових значень enum значень нуля, якщо значення не являє "очищені всі прапори" та не названо відповідним чином, як це визначено в наступному керівництві.

✔️ НАЗВАЙТЕ нульове значення, якщо прапор перераховується None. Для enum прапора значення завжди повинно означати "всі прапори очищені".

Ну, я думаю, я не погоджуюся з більшістю відповідей, які говорять про те, щоб явно їх не нумерувати. Я завжди чітко їх нумерую, але це тому, що в більшості випадків я в кінцевому підсумку зберігаю їх у потоці даних, де вони зберігаються як ціле значення. Якщо явно не додати значення, а потім додати нове значення, ви можете порушити серіалізацію, а потім не зможете точно завантажити старі збережені об'єкти. Якщо ви збираєтеся робити будь-який тип постійного зберігання цих значень, я б дуже рекомендував чітко встановити ці значення.

Enum - це тип значення, і його значення за замовчуванням (наприклад, для поля Enum у класі) буде 0, якщо не буде ініціалізовано явно.

Тому, як правило, ви хочете мати 0 як визначену константу (наприклад, невідомо).

У вашому прикладі, якщо ви хочете Inactiveбути типовим, то воно повинно мати значення нуль. В іншому випадку ви можете розглянути можливість додавання константи Unknown.

Деякі люди рекомендують не чітко вказувати значення для своїх констант. Мабуть, хороша порада в більшості випадків, але є деякі випадки, коли вам захочеться це зробити:

• Прапори перераховують

• Енуми, значення яких використовуються в взаємодії з зовнішніми системами (наприклад, COM).

Якщо у вас немає конкретної причини змінити його, залиште перерахунки зі своїми значеннями за замовчуванням, які починаються з нуля.

public enum Status : byte
{
    Inactive,
    Active
}

Я б сказав, що найкраща практика полягає в тому, щоб не нумерувати їх, а дозволити це неявно - що починається з 0. Оскільки це неявне, мовні переваги, яких завжди добре слідувати :)

Я би розпочав перерахунок булевого типу з 0.

Якщо тільки "Неактивний" означає щось інше, ніж "Неактивний" :)

Це зберігає стандарт для тих.

Я б сказав, це залежить від того, як ти їх використовуєш. Для позначення переліків переліком є ​​хорошою практикою мати Noneзначення 0 , наприклад:

[Flags]
enum MyEnum
{
    None = 0,
    Option1 = 1,
    Option2 = 2,
    Option3 = 4,
    All = Option1 | Option2 | Option3,
}

Коли ваш перерахунок, ймовірно, буде відображений у таблиці пошуку бази даних, я б почав його з 1. Це не має великого значення для професійно написаного коду, але це покращує читабельність.

В інших випадках я залишаю це так, як є, не хвилюючись, починають вони з 0 або 1.

Якщо у вас немає вагомих причин використовувати необроблені значення, ви повинні завжди використовувати лише неявні значення та посилатись на них з Status.Activeта Status.Inactive.

Суть полягає в тому, що ви, можливо, захочете зберігати дані у плоському файлі чи БД, або використовувати плоский файл або БД, які створив хтось інший. Якщо ви робите це самостійно, зробіть так, щоб нумерація відповідала тому, для чого використовується Enum.

Якщо дані не ваші, звичайно, ви хочете використовувати все те, що оригінальний розробник використовував як схему нумерації.

Якщо ви плануєте використовувати Enum як набір прапорів, існує проста конвенція, якої варто дотримуватися:

enum Example
{
  None      = 0,            //  0
  Alpha     = 1 << 0,       //  1
  Beta      = 1 << 1,       //  2
  Gamma     = 1 << 2,       //  4
  Delta     = 1 << 3,       //  8
  Epsilon   = 1 << 4,       // 16
  All       = ~0,           // -1
  AlphaBeta = Alpha | Beta, //  3
}

Значення мають бути двома потужностями і можуть бути виражені за допомогою операцій зсуву бітів. None, очевидно, має бути 0, але Allменш очевидно -1. ~0є двійковим запереченням 0і приводить до числа, для якого встановлено кожен біт 1, який представляє значення-1 . Для складених прапорів (які часто використовуються для зручності) інші значення можуть бути об'єднані за допомогою бітового або оператора |.

Не призначайте жодних чисел. Просто використовуйте його так, як слід було використовувати.

Якщо не вказано, нумерація починається з 0.

Важливо бути явним, оскільки переписки часто серіалізуються і зберігаються як int, а не рядок.

Для будь-якого перерахунку, що зберігається в базі даних, ми завжди чітко нумеруємо параметри, щоб запобігти зміщенню та перепризначення під час обслуговування.

На думку Microsoft, рекомендована конвенція полягає у використанні першої нульової опції для представлення неініціалізованого або найбільш поширеного значення за замовчуванням.

Нижче наведено ярлик для початку нумерації з 1 замість 0.

public enum Status : byte
{
    Inactive = 1,
    Active
}

Якщо ви хочете встановити значення прапорців, щоб використовувати бітові оператори для значень перерахувань, не починайте нумерацію з нульового значення.

Якщо ви почнете з 1, ви зможете легко отримати кількість своїх речей.

{
    BOX_THING1     = 1,
    BOX_THING2     = 2,
    BOX_NUM_THING  = BOX_THING2
};

Якщо ви починаєте з 0, то використовуйте перший як значення для неініціалізованих речей.

{
    BOX_NO_THING   = 0,
    BOX_THING1     = 1,
    BOX_THING2     = 2,
    BOX_NUM_THING  = BOX_THING2
};

Перш за все, якщо ви не вказуєте конкретні значення з причини (числове значення має значення десь в іншому місці, тобто База даних або зовнішня служба), тоді взагалі не вказуйте числові значення і нехай вони будуть явними.

По-друге, у вас завжди повинен бути елемент з нульовим значенням (в перерахунках без прапорців). Цей елемент буде використовуватися як значення за замовчуванням.

Не запускайте їх з 0, якщо немає причин, наприклад, використовувати їх як індекси до масиву чи списку, або якщо є якась інша практична причина (наприклад, використання їх у побітових операціях).

Ви enumповинні почати саме там , де це необхідно. Він також не повинен бути послідовним. Значення, якщо вони прямо встановлені, повинні відображати певний смисловий сенс або практичний розгляд. Наприклад, enum"пляшки на стіні" повинні бути пронумеровані від 1 до 99, тоді як enumдля потужностей 4, мабуть, слід починати з 4 і продовжувати з 16, 64, 256 і т.д.

Крім того, додавання до нульового елемента елемента enumслід робити, лише якщо він є дійсним станом. Іноді "жоден", "невідомий", "відсутній" тощо є дійсними значеннями, але багато разів вони не є.

Мені подобається запускати перерахунки на 0, оскільки це за замовчуванням, але я також хочу включити значення Невідомо зі значенням -1. Потім це стає за замовчуванням і може допомогти при налагодженні іноді.