Умовні позначення php

Попередня ↔ Наступна

Довідковий матеріал з основних мов програмування і верстки сайтів.

Готова методика створення простих і складних динамічних сайтів, з використанням PHP і MySQL.

Розробка веб-сайтів під "ключ".

Розробка окремих фрагментів сайтів, консультації з питань верстки веб-сторінок і веб-програмування.

Веб-інструмент

Веб-майстерня

Веб-послуги

Веб-графіка

Веб-ресурси

Хочете бути в курсі подій, що відбуваються на сайті? Підпишіться на отримання останніх новин та статей.

Подивіться в Google

Умовні позначення PHP

FuncName ( $ Param1 [, $ Param2])

Функція робить те-то і те-то. Повертає то-то. Тут має бути наведений опис функції, що повертає значення типу і приймаючої один або два аргументи (другий аргумент необов'язковий, на що вказують квадратні дужки). Тип першого параметра . а другого - . Опис можливих типів, які тут виділені кутовими дужками, наводиться в наступних підрозділах.

string - звичайна рядок, або тип, який можна перевести в рядок.
int, long - ціле число, або дійсне число (в останньому випадку дрібна частина відсікається), або рядок, що містить число в одному з перерахованих форматів. Якщо рядок не вдається перевести в int. то замість неї підставляється 0, і ніяких попереджень не генерується!
double, float - дійсне число, або ціле число, або рядок, що містить одне з таких чисел.
bool - логічний тип, який буде сприйматися або як брехня (нульове число, порожній рядок або константа false), або як істина (все інше). Зазвичай рідко вказується цей тип (замість нього пишуть int. Хоча це і не так).
array - масив, в загальному випадку асоціативний (див. нижче). Тобто набір пар ключ => значення. Втім, тут може бути переданий і список list.
list - зазвичай це масив з цілими ключами, пронумерованими від 0 і наступними поспіль. Так як список є різновидом асоціативного масиву, то зазвичай замість параметрів функцій типу list можна підставляти і параметри типу array.

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

object - об'єкт якоїсь структури. Зазвичай ця структура буде уточнюватися.

void - мабуть, найпростіший тип, який застосовується тільки для визначення повертається функцією значення, його можна охарактеризувати так: "Немає повернення нічого цінного". У PHP функція не може нічого не повертати (так уже він улаштований), тому практично всі void -Функції повертають false (тобто порожній рядок).

mixed - все, що завгодно. Це може бути ціле або дробове число, рядок, масив або об'єкт. Наприклад, параметр типу mixed має стандартна функція gettype () або функція settype (). Якщо написано, що функція повертає mixed, це означає, що тип результату залежить від операндів і уточнюється при описі функції.

Увага! При написанні функцій ні в якому разі не набирайте ці імена типів! Вони потрібні тільки для того, щоб уточнити синтаксис якоїсь функції.