Документация

Всё, что нужно знать, чтобы писать программы на RK.

1. Вывод на экран

Команда печатай показывает текст или числа:

печатай("Привет, мир!")
печатай(2 + 2)

2. Переменные

Имена переменных можно писать по-русски:

имя = "Аня"
возраст = 17
печатай(имя, возраст)

3. Ввод от пользователя

имя = ввод("Как тебя зовут? ")
печатай("Привет, " + имя)

4. Условия

возраст = 18
если возраст >= 18:
    печатай("Совершеннолетний")
иначе если возраст >= 14:
    печатай("Подросток")
иначе:
    печатай("Ребёнок")

5. Циклы

Цикл «для каждого» перебирает числа или элементы списка:

для каждого н в диапазон(5):
    печатай(н)

Цикл «пока» повторяется, пока условие верно:

счёт = 0
пока счёт < 3:
    печатай("шаг", счёт)
    счёт = счёт + 1

6. Функции

функция сумма_двух(а, б):
    верни а + б

печатай(сумма_двух(3, 5))

7. Списки

фрукты = ["яблоко", "банан", "груша"]
для каждого ф в фрукты:
    печатай(ф)
печатай("Всего:", длина(фрукты))

8. Рисование черепахой

из черепаха импортируй *

фон("чёрный")
цвет("золотой")
для каждого луч в диапазон(5):
    вперёд(200)
    направо(144)
готово()

Команды черепахи: вперёд, назад, направо, налево, цвет, толщина, скорость, перо_вверх, перо_вниз, круг, фон, заливка_начало, заливка_конец, спрячь, готово.

🐢 Черепаха теперь рисует прямо в браузере! Открой Песочницу, выбери пример «рисунок черепахой» и нажми ▶ — картинка появится сразу. Работает и на компьютере в VS Code.

9. Другие библиотеки

импортируй random как случай
печатай(случай.randint(1, 6))

У популярных библиотек есть русские названия — можно писать по-русски:

импортируй математика
печатай(математика.sqrt(81))

из случайности импортируй randint
печатай(randint(1, 100))

Русские имена: математика (math), случайности (random), время (time), система (sys), статистика (statistics), календарь (calendar), дата_время (datetime). Английские названия тоже работают.

10. Встроенные функции (без импорта)

Эти функции работают сразу, ничего подключать не нужно:

печатай("Корень из 144:", корень(144))
печатай("2 в степени 10:", степень(2, 10))
печатай("Число пи:", округли(пи, 2))
печатай("Кубик:", случайное(1, 6))
печатай("Монетка:", выбор(["орёл", "решка"]))

Доступно: корень, степень, случайное(от, до), выбор(список), перемешать(список), ввод_числа(), ввод_дробного(), заглавные(текст), строчные(текст), развернуть(список), а также пи и е.

Ещё функции для текста и списков: соедини(список, разделитель), раздели(текст, разделитель), замени(текст, что, на), содержит(где, что), чётное(н), нечётное(н).

Математика: округли_вверх(x), округли_вниз(x), остаток(a, b), целочисленно(a, b), случайное_дробное(от, до), модуль(x), среднее(список).

Текст: начинается_с(текст, часть), заканчивается_на(текст, часть), убери_пробелы(текст), повтори_текст(текст, н), это_число(текст).

Списки: найди(где, что), посчитай(где, что), добавь(список, элемент), убери(список, элемент), вставь(список, индекс, элемент).

Можно писать тогда после условия — оно необязательно: если возраст >= 18 тогда:

11. Повтор «N раз»

Чтобы повторить что-то несколько раз, не обязательно писать цикл — есть короткая запись:

повтори 3 раза:
    печатай("Ура!")

Работает с любым числом или переменной: повтори н раз:

12. Окна и кнопки (графика) 🪟

Библиотека окно делает настоящие окна с кнопками, надписями и рисованием. Работает на компьютере (кнопка ▶ в VS Code), в браузере окна показать нельзя.

из окно импортируй *

создай_окно("Привет", 400, 300)
н = надпись("Как тебя зовут?", размер=18)
имя = поле()

функция поздороваться():
    н.измени("Привет, " + имя.текст() + "!")

кнопка("Поздороваться", поздороваться)
запусти()

А так можно рисовать на «холсте»:

из окно импортируй *

создай_окно("Рисунок", 300, 300)
х = холст(280, 250, цвет_фона="белый")
х.круг(140, 120, 60, "красный")
х.прямоугольник(40, 40, 50, 50, "синий")
х.текст(140, 220, "Привет!", "чёрный")
запусти()

Команды: создай_окно(заголовок, ширина, высота), надпись(текст), кнопка(текст, функция), поле() (читается через .текст()), сообщение(текст), вопрос(текст), спроси(текст), холст(ширина, высота), каждые(мс, функция) для анимации, и запусти() в самом конце.

Можно делать игры! Управляй фигурами с клавиатуры и двигай их в игровом цикле:

из окно импортируй *

создай_окно("Двигай героя", 400, 400)
поле_игры = холст(400, 400, цвет_фона="чёрный")
герой = поле_игры.круг(200, 200, 15, "зелёный")

функция вверх():  поле_игры.двигай(герой, 0, -20)
функция вниз():   поле_игры.двигай(герой, 0, 20)
функция влево():  поле_игры.двигай(герой, -20, 0)
функция вправо(): поле_игры.двигай(герой, 20, 0)

когда_клавиша("вверх", вверх)
когда_клавиша("вниз", вниз)
когда_клавиша("влево", влево)
когда_клавиша("вправо", вправо)
запусти()

Команды для игр: когда_клавиша("вверх", функция) (или "вниз", "влево", "вправо", "пробел", буква), холст.двигай(фигура, dx, dy), .удали(фигура), .координаты(фигура), .размести(фигура, x, y), и игровой_цикл(функция, задержка_мс).

13. Помощник RK 🤖

Не понимаешь что-то? Нажми кнопку 🤖 в правом нижнем углу любой страницы и спроси по-русски — помощник объяснит и напишет код на RK. А в Песочнице есть кнопка «🤖 Объясни код»: вставь любую программу и помощник разберёт её по шагам.

Словарь языка

Полный список ключевых слов RK.

RKЧто делает
печатайвывести на экран
вводспросить у пользователя
если / иначе / иначе еслиусловия
покацикл с условием
для каждого … в …цикл перебора
функцияопределить функцию
вернивернуть значение
класссоздать класс
и / или / нелогические операции
истина / ложь / ничегоTrue / False / None
диапазонпоследовательность чисел
длинадлина списка или строки
целое / дробное / строкапреобразование типов
список / словарь / множествоколлекции
макс / мин / сумма / сортироватьработа с числами и списками
импортируй … какподключить библиотеку
из … импортируй …подключить часть библиотеки
попробуй / кроме / наконецобработка ошибок
прерви / продолжи / пропустиуправление циклом