Оператори

This article describes Zephir’s operators. For precedence, you can check the Operator Precedence article.

Zephir’s operators are similar to the ones in PHP, and inherit some of their behaviors.

Арифметичні оператори

Підтримуються наступні оператори:

Операція Приклад
Заперечення (зміна знаку) -a
Додавання a + b
Віднімання a - b
Множення a * b
Ділення a / b
Ділення по модулю a % b

Бітові оператори

Підтримуються наступні оператори:

Операція Приклад
І (кон’юнкція) a & b
Або (диз’юнкція) a | b
Виключення або (виключна диз’юнкція) a ^ b
Заперечення ~a
Зсув ліворуч a << b
Зсув праворуч a >> b

Приклад:

if a & SOME_FLAG {
    echo "Прапорець встановлений";
}

Learn more about comparison of dynamic variables in the php manual.

Оператори порівняння

Операції порівняння залежать від типу порівнюваних змінних. Наприклад, якщо обидва операнди динамічні, то результат буде таким же як і в PHP:

Приклад Операція Опис
a == b Рівність true, якщо a дорівнює b після приведення типів.
a === b Ідентичність (тотожність) true, якщо a дорівнює b, і операнди одного типу.
a != b Нерівність true, якщо a не дорівнює b після приведення типів.
a <> b Нерівність true, якщо a не дорівнює b після приведення типів.
a !== b Не ідентичність (різниця) true, якщо a не дорівнює b або коли в операнд різні типи.
a < b Менше ніж true, якщо a строго менше b.
a > b Більше ніж true, якщо a строго більше b.
a <= b Менше ніж або дорівнює true, якщо a менше або дорівнює b.
a >= b Більше ніж або дорівнює true, якщо a більше або дорівнює b.

Приклад:

if a == b {
    return 0;
} else {
    if a < b {
        return -1;
    } else {
        return 1;
    }
}

Логічні оператори

Підтримуються наступні оператори:

Операція Приклад
І (кон’юнкція) a && b
Або a || b
Заперечення !a

Приклад:

if a && b || !c {
    return -1;
}
return 1;

Тернарний оператор

Zephir підтримує тернарний оператор, як в C або PHP:

let b = a == 1 ? "x" : "y"; // b буде присвоєно "x", якщо a дорівнює 1, інакше "y"

Спеціальні оператори

Підтримуються наступні оператори:

Empty

Цей оператор дозволяє перевірити вираз на порожнечу. Під “порожнечею” мається на увазі вираз, який дорівнює null, порожньому рядку або порожньому масиву:

let someVar = "";
if empty someVar {
    echo "порожньо!";
}

let someVar = "hello";
if !empty someVar {
    echo "не порожньо!";
}

Fetch

Оператор “fetch” створений для скорочення популярної в PHP конструкції:

<?php

if (isset($myArray[$key])) {
    $value = $myArray[$key];
    echo $value;
}

У Zephir ви можете написати той самий код так:

if fetch value, myArray[key] {
    echo value;
}

Оператор “fetch” поверне true, якщо в масиві присутній ключ key і присвоїть значення змінній value.

Isset

Перевіряє, чи існує індекс у масиву або властивість у об’єкта:

let someArray = ["a": 1, "b": 2, "c": 3];
if isset someArray["b"] { // перевіряє чи є в масиву індекс "b"
    echo "yes, it has an index 'b'\n";
}

Використання isset можливе і в конструкціях повернення:

return isset this->{someProperty};

Note that isset in Zephir works more like PHP’s function array_key_exists, isset in Zephir returns true even if the array index or property is null.

Typeof

Цей оператор перевіряє тип змінної. Оператор typeof можна використовувати з порівняльним оператором:

if (typeof str == "string") { // або !=
    echo str;
}

Він також може працювати як PHP-функція gettype.

return typeof str;

Be careful, if you want to check whether an object is ‘callable’, you always have to use typeof as a comparison operator, not a function.

Підказка типа

Zephir завжди намагається перевірити, чи реалізує об’єкт методи та властивості викликання/доступу до змінної, яка виводиться як об’єкт:

let o = new MyObject();

// Zephir перевіряє чи реалізований метод "myMethod" в MyObject
o->myMethod();

Проте через динамічну природу, яка успадкована від PHP, іноді нелегко дізнатися клас об’єкта, тому Zephir не може ефективно створювати звіти про помилки. Підказка типу повідомляє компілятору, який клас пов’язаний з динамічною змінною, що дозволяє компілятору виконувати більше перевірок компіляції:

// Повідомляє компілятору, що "o"
// є екземпляром класу MyClass
let o = <MyClass> this->_myObject;
o->myMethod();

These “type hints” are weak. This means the program does not check if the value is in fact an instance of the specified class, nor whether it implements the specified interface. If you want it to check this every time in execution, use a strict type:

// Always check if the property is an instance
// of MyClass before the assignment
let o = <MyClass!> this->_myObject;
o->myMethod();

Branch Prediction Hints

What is branch prediction? Check this article or refer to the Wikipedia article. In environments where performance is very important, it may be useful to introduce these hints.

Consider the following example:

let allPaths = [];
for path in this->_paths {
    if path->isAllowed() == false {
        throw new App\Exception("Якась помилка");
    } else {
        let allPaths[] = path;
    }
}

The authors of the above code know in advance that the condition that throws the exception is unlikely to happen. This means that, 99.9% of the time, our method executes that condition, but it is probably never evaluated as true. For the processor, this could be hard to know, so we could introduce a hint there:

let allPaths = [];
for path in this->_paths {
    if unlikely path->isAllowed() == false {
        throw new App\Exception("Якась помилка");
    } else {
        let allPaths[] = path;
    }
}