feat(40-define-functions): adapt content from Python version

- 100-syntax: rewrite README (function declaration, parameters, arrow intro); printMotto exercise
- 150-return: rewrite README (return vs console.log, early return); sayHurray exercise
- 340-default-parameters: rewrite README; getHiddenCard exercise with slice(-4)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: fey

modules/40-define-functions/100-define-functions-syntax/index.js

@@ -1,8 +1,9 @@
 // BEGIN
-const printMotto = () => {
+function printMotto() {
   console.log('Winter is coming');
-};
+}
 // END
 
-// exports are studied on Hexlet
+printMotto();
+
 export default printMotto;

modules/40-define-functions/100-define-functions-syntax/ru/EXERCISE.md

@@ -1,8 +1,7 @@
+Напишите функцию `printMotto()` без параметров, которая выводит на экран:
 
-Реализуйте функцию с именем `printMotto()`, которая выведет на экран фразу *Winter is coming*.
-
-```javascript
-printMotto(); // => Winter is coming
+```text
+Winter is coming
 ```
 
-В задачах, в которых нужно реализовать функцию, эту функцию вызывать не нужно. Вызывать функцию будут автоматизированные тесты, которые проверяют её работоспособность. Пример с вызовом выше показан только для того, чтобы вы понимали, как ваша функция будет использоваться.
+Затем вызовите эту функцию.

modules/40-define-functions/100-define-functions-syntax/ru/README.md

@@ -1,63 +1,52 @@
+Функции позволяют избежать повторения кода. Если одни и те же действия нужны в разных местах программы, их выносят в функцию.
 
-Определение собственных функций значительно упрощает написание и поддержку программ. Функции позволяют объединять сложные (составные) операции в одну. Например, отправка письма на сайте - это достаточно сложный процесс, включающий в себя взаимодействие с внешними системами (интернет). Благодаря возможности определять функции, вся сложность может быть скрыта за одной простой функцией:
+## Объявление функции
 
 ```javascript
-// Гипотетический пример
-// Место откуда берется функция
-import { send } from 'mailer';
-
-const email = 'support@hexlet.io';
-const title = 'Помогите';
-const body = 'Я написал историю успеха, как я могу получить скидку?';
+function sayHello() {
+  console.log('Hello!');
+}
 
-// Один маленький вызов — и много логики внутри
-send(email, title, body);
+// Вызов функции
+sayHello(); // => Hello!
+sayHello(); // => Hello! (можно вызвать сколько угодно раз)
 ```
 
-Внутри себя подобный вызов выполняет довольно много логики. Соединяется с почтовым сервером, формирует правильный запрос на основе заголовка и тела сообщения, а затем все это отправляет, не забыв закрыть соединение.
-
-Создадим нашу первую функцию. Ее задача - вывести на экран приветствие:
+Ключевое слово `function`, затем имя функции, скобки и тело в фигурных скобках.
 
-```textHello, Hexlet!```
+## Функции с параметрами
 
 ```javascript
-// Определение функции
-// Определение не вызывает и не выполняет функцию
-// Мы лишь говорим, что теперь такая функция существует
-const showGreeting = () => {
-  // Внутри тела отступ 2 пробела для удобства чтения
-  const text = 'Hello, Hexlet!';
-  console.log(text);
+function greet(name) {
+  console.log(`Hello, ${name}!`);
 }
 
-// Вызов функции
-showGreeting(); // => Hello, Hexlet!
+greet('Alice'); // => Hello, Alice!
+greet('Bob');   // => Hello, Bob!
 ```
 
-В отличие от обычных данных, функции выполняют действия, поэтому их имена практически всегда должны быть глаголами: «построить что-то», «нарисовать что-то», «открыть что-то».
+Параметр `name` — это переменная, доступная внутри функции. При каждом вызове в неё подставляется переданный аргумент.
 
-Всё, что описывается внутри фигурных скобок `{}`, называется телом функции. Внутри тела можно описывать любой код. Считайте, что это маленькая самостоятельная программа, набор произвольных инструкций. Тело выполняется ровно в тот момент, когда запускается функция. Причём каждый вызов функции запускает тело независимо от других вызовов. Кстати, тело может быть пустым:
+## Несколько параметров
 
 ```javascript
-// Минимальное определение функции
-const noop = () => {
-  // Тут мог бы быть код, но его нет
+function add(a, b) {
+  console.log(a + b);
 }
 
-noop();
+add(3, 4); // => 7
 ```
 
-Определение функции подозрительно похоже на создание константы. Действительно, в реальности, определение функции состоит из двух частей: собственно определения и присваивания константе:
-
-1. Определение: `() => { }`
-2. Присваивание `const nameOfFunction = ...`
+## Стрелочные функции
 
-Технически возможно создать функцию, которая просто определена, но ей невозможно воспользоваться, потому что нет имени:
+В JavaScript есть сокращённая запись через стрелку `=>`:
 
 ```javascript
-() => {
-  // Работающий, но бесполезный код
+const greet = (name) => {
+  console.log(`Hello, ${name}!`);
 };
+
+greet('Alice'); // => Hello, Alice!
 ```
 
-Понятие «создать функцию» имеет много синонимов: «реализовать», «определить» и даже «заимплементить» (от слова implement). Все они встречаются в повседневной практике на работе.
+Обе формы равнозначны, но стрелочная функция записывается в переменную.

modules/40-define-functions/150-define-functions-return/index.js

@@ -1,8 +1,9 @@
 // BEGIN
-const sayHurrayThreeTimes = () => {
-  const word = 'hurray!';
-  return `${word} ${word} ${word}`;
-};
+function sayHurray() {
+  return 'hurray! hurray! hurray!';
+}
 // END
 
-export default sayHurrayThreeTimes;
+console.log(sayHurray());
+
+export default sayHurray;

modules/40-define-functions/150-define-functions-return/ru/EXERCISE.md

@@ -1,7 +1,3 @@
+Напишите функцию `sayHurray()`, которая возвращает строку `'hurray! hurray! hurray!'`.
 
-Реализуйте функцию `sayHurrayThreeTimes()`, которая возвращает строку 'hurray! hurray! hurray!'.
-
-```javascript
-const hurray = sayHurrayThreeTimes();
-console.log(hurray); // => hurray! hurray! hurray!
-```
+Затем выведите результат вызова функции на экран.

modules/40-define-functions/150-define-functions-return/ru/README.md

@@ -1,114 +1,44 @@
-
-Функции, которые мы определяли в предыдущих уроках, заканчивали свою работу тем, что печатали на экран какие-то данные:
-
-```javascript
-const greeting = () => {
-  console.log('Hello, Hexlet!');
-};
-```
-
-Пользы от таких функций не очень много, так как результатом их работы невозможно воспользоваться внутри программы. Рассмотрим это на примере.
-
-Возьмем задачу обработки электронной почты. Когда пользователь регистрируется на каком-то сайте, то он может ввести email любым способом:
-
-* Добавив случайно пробелы в начале или в конце `_support@hexlet.io__`
-* Использовав буквы в разном регистре `SUPPORT@hexlet.io`
-
-Если мы сохраним его в таком виде в базу данных, то пользователь, скорее всего, не сможет войти на сайт, так как будет вбивать адрес без пробелов и используя другой регистр символов. Чтобы этого не произошло, email нужно подготовить к записи в базу, привести его к нижнему регистру и обрезать пробельные символы по краям строки. Вся задача решается в пару строчек:
-
-```javascript
-const saveEmail = () => {
-  // В реальности email приходит из формы
-  const email = '  SuppORT@hexlet.IO';
-  // обрезаем пробельные символы
-  const trimmedEmail = email.trim();
-  const preparedEmail = trimmedEmail.toLowerCase();
-  console.log(preparedEmail);
-  // здесь будет запись в базу данных
-};
-```
-
-Этот код стал возможен только благодаря возврату значения. Методы `trim()` и `toLowerCase()` ничего не печатают на экран (в консоль), они **возвращают** результат своей работы и поэтому мы можем записать его в константы. Если бы они вместо этого печатали на экран, мы бы не могли присвоить результат их работы константе. Как мы не можем сделать с определенной выше функцией `greeting()`:
-
-```javascript
-const message = greeting();
-console.log(message); // => undefined
-```
-
-Изменим функцию `greeting()` таким образом, чтобы она начала возвращать данные, вместо их печати. Для этого нам понадобится выполнить возврат вместо печати на экран
+Функция может не только выполнять действия, но и **возвращать результат** с помощью оператора `return`.
 
 ```javascript
-const greeting = () => {
-  return 'Hello, Hexlet!';
-};
-```
-
-`return` – особая инструкция, которая берёт выражение, записанное справа. Затем она отдаёт это выражение наружу, тому коду, который вызвал функцию. Как только JavaScript натыкается на `return`, выполнение функции на этом завершается.
-
-```javascript
-// Теперь мы можем использовать результат работы функции
-const message = greeting();
-console.log(message); // => Hello, Hexlet!
-// И даже выполнить какие-то действия над результатом
-console.log(message.toUpperCase()); // => HELLO, HEXLET!
-```
-
-Любой код после `return` не выполняется:
+function add(a, b) {
+  return a + b;
+}
 
-```javascript
-const greetingWithCodeAfterReturn = () => {
-  return 'Hello, Hexlet!';
-  console.log('Я никогда не выполнюсь');
-};
+const result = add(3, 4);
+console.log(result); // => 7
 ```
 
-Даже если функция возвращает данные, это не ограничивает её в том, что она печатает. Кроме возврата данных мы можем и печатать:
+## Разница между return и console.log
 
 ```javascript
-const greetingWithReturnAndPrinting = () => {
-  console.log('Я появлюсь в консоли');
-  return 'Hello, Hexlet!';
-};
-
-// И напечатает текст на экран и вернет значение
-const message = greetingWithReturnAndPrinting ();
-```
+// Эта функция выводит, но ничего не возвращает
+function printSum(a, b) {
+  console.log(a + b);
+}
 
-Возвращать можно не только конкретное значение. Так как `return` работает с выражениями, то справа от него может появиться почти все что угодно. Здесь нужно руководствоваться принципами читаемости кода:
+// Эта функция возвращает результат
+function getSum(a, b) {
+  return a + b;
+}
 
-```javascript
-const greeting = () => {
-  const message = 'Hello, Hexlet!';
-  return message;
-};
+// Вернувший результат можно использовать дальше
+const sum = getSum(3, 4);
+console.log(sum * 2); // => 14
 ```
 
-Здесь мы не возвращаем переменную, возвращается всегда значение, которое находится в этой переменной. Ниже пример с вычислениями:
-
-```javascript
-const doubleFive = () => {
-  // или return 5 + 5
-  const result = 5 + 5;
-  return result;
-};
-```
+## return завершает функцию
 
-Вопрос на самопроверку. Что вернет вызов, определенной ниже, функции `run()`?
+После `return` функция немедленно завершается. Код после `return` не выполняется.
 
 ```javascript
-// Определение
-const run = () => {
-  return 5;
-  return 10;
-};
+function getSign(n) {
+  if (n > 0) return 'positive';
+  if (n < 0) return 'negative';
+  return 'zero';
+}
 
-// Что будет выведено на экран?
-console.log(run());
+console.log(getSign(5));  // => positive
+console.log(getSign(-3)); // => negative
+console.log(getSign(0));  // => zero
 ```
-
-<details>
-<summary>Ответ</summary>
-
-На экран будет выведено `5`.
-
-</details>

modules/40-define-functions/340-define-functions-default-parameters/index.js

@@ -1,8 +1,7 @@
 // BEGIN
-const getHiddenCard = (cardNumber, starsCount = 4) => {
-  const visibleDigitsLine = cardNumber.slice(12);
-  return `${'*'.repeat(starsCount)}${visibleDigitsLine}`;
-};
+function getHiddenCard(cardNumber, starsCount = 4) {
+  return '*'.repeat(starsCount) + cardNumber.slice(-4);
+}
 // END
 
 export default getHiddenCard;

modules/40-define-functions/340-define-functions-default-parameters/ru/EXERCISE.md

@@ -1,17 +1,8 @@
-
-Реализуйте функцию `getHiddenCard()`, которая принимает на вход номер кредитки (состоящий из 16 цифр) в виде строки и возвращает его скрытую версию. Скрытая версия может использоваться на сайте для отображения. Если исходная карта имела номер *2034399002125581*, то скрытая версия выглядит так *\*\*\*\*5581*. Другими словами, функция заменяет первые 12 символов, на звездочки. Количество звездочек регулируется вторым необязательным параметром. Значение по умолчанию — 4.
+Напишите функцию `getHiddenCard(cardNumber, starsCount = 4)`, которая принимает номер карты (строку) и возвращает скрытый номер: звёздочки + последние 4 цифры.
 
 ```javascript
-// Кредитка передается внутрь как строка
-getHiddenCard('1234567812345678', 2); // **5678
-getHiddenCard('1234567812345678', 3); // ***5678
-getHiddenCard('1234567812345678');    // ****5678
-getHiddenCard('2034399002121100', 1); // *1100
+getHiddenCard('1234567890123456')    // => '****3456'
+getHiddenCard('1234567890123456', 2) // => '**3456'
 ```
 
-Для выполнения задания вам понадобится метод строки `repeat()`, который повторяет строку указанное количество раз
-
-```javascript
-'+'.repeat(5); // +++++
-'o'.repeat(3); // ooo
-```
+Используйте `'*'.repeat(starsCount)` и `.slice(-4)`.