> For the complete documentation index, see [llms.txt](https://shpp.gitbook.io/zero/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shpp.gitbook.io/zero/tutorials/functions.md).

# Функції

Функції — це можливість створювати власні команди.

Часто буває ситуація, коли якийсь блок коду повторюється в програмі більше одного разу. Так ось, ви можете цьому блоку коду дати ім'я, і це буде називатися функцією. Потім можна буде викликати цю функцію багато разів, так само як ви викликаєте функції `console.log`, `alert`, `prompt` і т.д.

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

Наприклад, функція console.log приймає параметр, який вона виводить на екран. Функція Math.min (1,2) приймає два параметри, і повертає найменше число з переданих їй.

Оголосити функцію можна за допомогою ключового слова `function`, за яким слідує ім'я функції і список її аргументів, розділених комою і заключений в дужки.

```javascript
function funcName(arg1, arg2, ...) {
    // do something
}
```

Приклад функції, яка робить щось корисне:

```javascript
function good(name) {
   console.log("YOU ARE COOL, " + name + "! :-)");
}
```

Цей код створить функцію (команду) з назвою `good`, але не викличе її. Тепер, якщо раптово нам треба вивести на екран якесь мотиваційне повідомлення, ми можемо просто сказати:

```javascript
good("Vasya") // виведе на екран: YOU ARE COOL, Vasya! :-)
```

Команда `return` потрібна для того, щоб функція **повернула** значення туди, звідки вона була викликана. Як `prompt` наприклад. Або синус якогось кута в тригонометрії, теж повертає власне число.

```javascript
function sum(a, b) {
    return a + b;
}

console.log(sum(1, 2)); // 3
```

У функції може бути кілька команд return, але комп'ютер закінчить виконання функції при зустрічі першої з них.

```javascript
function sum(a, b) {
    if (a == 0 && b == 0) {
        return 1; // ха-ха
    }
    return a + b;
}

console.log(sum(0, 0)); // що буде?
```

Якщо ж при виклику функції виконана в ній гілка коду не містила ключового слова return, то функція повертає спеціальне значення `undefined`. Можете пошукати про нього в інтернеті.

```javascript
function f() {
  // пусте тіло функції з ім'ям f
}
console.log(f()); // undefined
```

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

```javascript
console.log(sum(2, 3)); // 5
console.log(sum(3, 3)); // 6
console.log(sum(3, 7)); // 10
```

Як аргументи у функцію можна передавати будь-які допустимі в js вирази.

```javascript
console.log(sum(2 + 3, 3)); // 8

let a = 10, b = -10;

console.log(sum(a, b)); // 0
console.log(sum(sum(5, 3), 2)); // 10
```

Тепер з'ясуйте, чому:

```javascript
function wow(b) {
    b = b + 1;
}

let a = 10;
wow(a);
console.log(a); // ??????
```

Щоб перевірити себе, передбачте:

```javascript
function wow(a) {
    a = a + 1;
}

let a = 10;
wow(a);
console.log(a); // ??????
```

Якщо з'ясували чому так, передбачте:

```javascript
function wow(a) {
    a = a + 1;
    return a;
}

let a = 10;
wow(a);
console.log(a); // ??????
```

... вам треба добре розуміти, як працюють функції.

Якщо ви вже пройшли масиви, то читайте наступний блок, інакше можете пропустити:

### Передача масивів у функції

Як ви пам'ятаєте з теми про масиви, коли ми пишемо `A = B` і при цьому `B` це масив, то ми скопіюємо не масив, а тільки посилання на нього, в змінну A. Те ж саме при передачі масиву в функцію — ми передамо посилання на нього, і якщо функція змінить вміст масиву, то ... він зміниться :) Детальніше ви з цим розберетесь тільки після вступу в Ш++, для складання вступного тестування вам ця інформація не знадобиться :)

### Оголошення та виклик функцій

Оголошення — це первинний опис функції. Оголошення == створення.\
Виклик —  це коли, власне, викликаємо функцію будь-де. Виклик == використання.

Все як зі змінними, тільки для оголошення —`function` замість `let`

```javascript
// це оголошення функції myFunction
function myFunction (arg) {
    console.log(arg); // це те, що функція робить (її тіло)
}

myFunction("якийсь текст"); // а це виклик
myFunction(12345); // і це виклик
myFunction(); // і це
```

### Функції в функціях

JavaScript дозволяє створювати функції і в глобальному [скоупі](/zero/tutorials/nagadaiki-poyasnyaiki.md#skoup), так і всередині інших функцій. Причому функції всередині та ззовні можуть навіть мати однакові імена, і це не викликатиме помилку. Чому так — знову ж, читайте про скоупи.

Сильно заморочуватись на цьому поки не варто. Просто знайте, що така можливість є.

Ось код:

```javascript
function foo () {
    console.log("foo");
    function bar () {
        console.log("bar in foo()");
    }
    bar();
}

function bar () {
    console.log("bar");
}

foo();
bar();
```

Закоментуйте по черзі *оголошення* `bar()` — внутрішню, зовнішню та обидві разом.\
Всі три варіанта запустіть і дивіться, що буде. Подумайте, чому саме так.

## **Додаткові матеріали**

[Про функції](https://uk.javascript.info/function-basics) *(uk.javascript.info)*

[Ще про функції](http://xn--80adth0aefm3i.xn--j1amh/function) *(яваскрипт.укр)*

Для вас ми записали власне відео про функції:

{% embed url="<https://www.youtube.com/watch?v=VlQNp2h2pwM>" %}

Вирішили залишити посилання і на це відео, можливо різні підходи допоможуть краще розібратись в темі:

{% embed url="<https://youtu.be/6cKoB5ijaGA>" %}

## Обов'язкові задачі

{% hint style="warning" %}
**Увага!** Тепер і серед обов'язкових задач цього розділу є задачі з Codewars. Тож, якщо ви ще не встигли — саме час розібратись. [Інструкції з Codewars](/zero/tutorials/codewars.md).
{% endhint %}

{% content-ref url="/pages/B1xwwfodRpGdda11CJdk" %}
[Hello world (Codewars)](/zero/tutorials/functions/hello-world-codewars.md)
{% endcontent-ref %}

{% content-ref url="/pages/lkc79waHGcZOHwaMQx5b" %}
[Найбільше число](/zero/tutorials/functions/max-number.md)
{% endcontent-ref %}

{% content-ref url="/pages/0DWRiubjMAOOmyJEcbLU" %}
[Масив у зворотному порядку](/zero/tutorials/functions/array-reversing.md)
{% endcontent-ref %}

*Виникли питання або труднощі?* [*Зверніться за допомогою до Ш++.*](/zero/arrangements/support.md)