Объявление и проверка/сравнение (bitmask-)enums в Objective-C

Объявление битмаски:

В качестве альтернативы назначению абсолютных значений (1, 2, 4, …) вы можете объявить битовые маски. (как они называются) вот так:

typedef enum : NSUInteger {
  FileNotDownloaded = (1 << 0), // => 00000001
  FileDownloading   = (1 << 1), // => 00000010
  FileDownloaded     = (1 << 2)  // => 00000100
} DownloadViewStatus;

или используя современные макросы ObjC NS_OPTIONS/NS_ENUM:

typedef NS_OPTIONS(NSUInteger, DownloadViewStatus) {
  FileNotDownloaded = (1 << 0), // => 00000001
  FileDownloading   = (1 << 1), // => 00000010
  FileDownloaded    = (1 << 2)  // => 00000100
};

(см. Abizern answer для получения дополнительной информации о последнем)

Концепция битовых масок заключается в том, чтобы (обычно) определять каждое значение перечисления с помощью одного набора битов.

Следовательно, ORing два значения делает следующее:

DownloadViewStatus status = FileNotDownloaded | FileDownloaded; // => 00000101

что эквивалентно:

  00000001 // FileNotDownloaded
| 00000100 // FileDownloaded
----------
= 00000101 // (FileNotDownloaded | FileDownloaded)

Сравнение битмасок:

При проверке битовых масок следует помнить одну вещь:

Проверка на точное равенство:

Предположим, что статус инициализирован следующим образом:

DownloadViewStatus status = FileNotDownloaded | FileDownloaded; // => 00000101

Если вы хотите проверить, является ли status равным FileNotDownloaded, вы можете использовать:

BOOL equals = (status == FileNotDownloaded); // => false

что эквивалентно:

   00000101 // (FileNotDownloaded | FileDownloaded)
== 00000100 // FileDownloaded
-----------
=  00000000 // false

Проверка на «принадлежность»:

Если вы хотите проверить, содержит ли status просто содержит FileNotDownloaded, вам нужно использовать:

BOOL contains = (status & FileNotDownloaded) != 0; // => true

   00000101 // (FileNotDownloaded | FileDownloaded)
&  00000100 // FileDownloaded
-----------
=  00000100 // FileDownloaded
!= 00000000 // 0
-----------
=  00000001 // 1 => true

Видите тонкую разницу (и почему ваше текущее выражение «если», вероятно, неверно)?

Хотя @Regexident предоставил отличный ответ, я должен упомянуть современный способ Objective-C объявления параметров перечисления с помощью NS_OPTIONS:

typedef NS_OPTIONS(NSUInteger, DownloadViewStatus) {
  FileNotDownloaded = 0,
  FileDownloading   = 1 << 0,
  FileDownloaded    = 1 << 1
};

Дополнительная ссылка:

• NSHipster
• Я Морж

enum DownloadViewStatus {
  FileNotDownloaded = 1,
  FileDownloading = 2,
  FileDowloaded = 4
};

Это позволит вам эффективно выполнять побитовые операции ИЛИ и И.

Полезная функция, которую вы можете использовать для проверки битовой маски для улучшения читабельности.

BOOL bitmaskContains(NSUInteger bitmask, NSUInteger contains) {
    return (bitmask & contains) != 0;
}