Як реалізувати бітову маску в php?

Я не впевнений, що бітмаска - це правильний термін. Дозволь пояснити:

У php error_reportingфункцію можна викликати кількома способами:

// Report simple running errors
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// Reporting E_NOTICE can be good too (to report uninitialized
// variables or catch variable name misspellings ...)
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// Report all errors except E_NOTICE
// This is the default value set in php.ini
error_reporting(E_ALL ^ E_NOTICE);

Я отримав термін bitmask зі сторінки php.net тут

У будь-якому випадку суть цього полягає в тому, що я реалізував SIMPLE метод, lsякий викликається, який повертає вміст каталогу.

Ця функція приймає 3 аргументи ... ($ include_hidden = false, $ return_absolute = false, $ ext = false)

Тому, коли я викликаю функцію, я встановлюю, як я хочу результати. Чи хочу я, щоб результати повертали приховані каталоги, чи хочу я лише базові імена тощо.

тому, коли я викликаю функцію, я пишу

ls(true, false, true)
ls(false, false, true)
ls(true, true, true)
etc...

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

так щось на зразок:

ls( INCLUDE_HIDDEN | HIDE_EXTS );
ls( SHOW_ABSOLUTE_PATHS | HIDE_EXTS );

тощо ...

Як я можу реалізувати це з точки зору тестування, які прапорці були викликані?

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

const FLAG_1 = 0b0001; // 1
const FLAG_2 = 0b0010; // 2
const FLAG_3 = 0b0100; // 4
const FLAG_4 = 0b1000; // 8
// Can you see the pattern? ;-)

function show_flags ($flags) {
  if ($flags & FLAG_1) {
    echo "You passed flag 1!<br>\n";
  }
  if ($flags & FLAG_2) {
    echo "You passed flag 2!<br>\n";
  }
  if ($flags & FLAG_3) {
    echo "You passed flag 3!<br>\n";
  }
  if ($flags & FLAG_4) {
    echo "You passed flag 4!<br>\n";
  }
}

show_flags(FLAG_1 | FLAG_3);

Демо

Оскільки прапори є цілими числами, на 32-бітовій платформі ви визначаєте до 32 прапорів. На 64-бітній платформі це 64. Також можна визначити прапори як рядки, і в цьому випадку кількість доступних прапорів є більш-менш нескінченною (звичайно, в межах системних ресурсів). Ось як це працює в двійковому (для простоти скоротити до 8-бітових цілих чисел).

FLAG_1
Dec:    1
Binary: 00000001

FLAG_2
Dec:    2
Binary: 00000010

FLAG_3
Dec:    4
Binary: 00000100

// And so on...

Коли ви поєднуєте прапори, щоб передати їх функції, ви АБО їх разом. Давайте подивимося, що відбувається, коли ми проїжджаємоFLAG_1 | FLAG_3

  00000001
| 00000100
= 00000101

І коли ви хочете побачити, які прапори були встановлені, ви І бітова маска з прапором. Отже, давайте візьмемо результат вище і подивимось, чи FLAG_3встановлено:

  00000101
& 00000100
= 00000100

... ми отримуємо значення прапора назад, ненульове ціле число, але якщо ми бачимо, чи FLAG_2було встановлено:

  00000101
& 00000010
= 00000000

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

define( "INCLUDE_HIDDEN", 0x1 );
define( "HIDE_EXTS", 0x2 );
define( "SHOW_ABSOLUTE_PATHS", 0x4 );
//And so on, 0x8, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, 0x400, 0x800 etc..

Потім ви можете перевірити наявність окремих прапорів у вашій lsфункції:

if( $flags & INCLUDE_HIDDEN ) { //<-- note just a single &, bitwise and
    //$flags have INCLUDE_HIDDEN
}

Інші запропонували хороші пропозиції, але в наш час набагато частіше передають асоціативні масиви замість бітових масок. Він набагато читабельніший і дозволяє передавати інші змінні, крім просто істинних / хибних значень. Щось на зразок цього:

myFunction(['includeHidden' => true, 'fileExts' => false, 'string' => 'Xyz']);

function myFunction($options) {
    // Set the default options
    $options += [
        'includeHidden' => false,
        'fileExts' => true,
        'string' => 'Abc',
    ];

    if ($options['includeHidden']) {
        ...
    }
    ...
}