UjAPI

Лаунчер для запуска

AngelScript

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

main

void main(){
	// Код начнёт исполняться здесь и можно создавать игровые объекты за исключением фреймов.
}

Вызов функции

void main(){ // Эта функция будет вызвана интерпретатором
	A(); // Вызываем объявленую ниже функцию A
}
void A(){
	print("Эта функция выведет этот текст в консоль");
}

Рекурсия

int A = 0;
void main(){
	A++; // увеличиваем значение переменной A на единицу
	print("Выводим этот текст в консоль");
	if (A < 5) main(); // повторно вызываем функцию main если A меньше 5
}

Возвращаемое значение

int A(){ // Объявляем функцию A которая возвращает значение типа int;
	return 5; // Возвращаем значение типа int равное 5
}
int B = A(); // Присваиваем глобальной переменной B результат вызова функции A, тобишь 5

void

void main(){} // Эта функция никому ничего не возвращает

Возврат ссылки

int A; // Объявляем неинициализрованную переменную A типа int
int& B(){ // Объявляем функцию, которая вернёт ссылку на переменную типа int
	return A;
}
void main(){
	B() = 5; // Вызываем функцию B и устанавливаем возвращаемой переменной A значение 5
}

Аргументы

void A(string B, string C) { // Объявление функции с именем A, которая принимает две строки B и C
	print(B+" "+C); // Делаем конкатенацию строк и выводим результат в консоль
}
void main(){
	A("Продам", "гараж"); // Вызываем функцию A и передаём ей две строки аргументами
}

Занимательная терминология

void A (int B /* это параметр */ = 5 /* это аргумент */) {}

void A (int B /* это параметр или аргумент или переменная функции */ = 5 /* это значение */) {}

Чтоб не быть голословным, приведём несколько примеров

Математика

Без неё вообще бы не появилось этого вашего программирования, и функции там появились задолго до того, как электричество изобрели.

С++

Чтоб описать как этот язык повлиял на современность необходимо написать целую книгу. Так что обойдёмся одним словом - сильно.

На странице описания функций можно найти определение:

The function can be invoked, or called, from any number of places in the program. The values that are passed to the function are the arguments, whose types must be compatible with the parameter types in the function definition.

Но перейдя в описание перегрузок сразу видим таблицу.

Если мы явно различаем параметры и аргументы, то выходит что параметры вообще не учавствуют в перегрузке. Что явно не так.

Rust

Новый виток развития компилируемых языков, чья популярность тому доказательство. В описании функций они указали это различие явно:

We can define functions to have parameters, which are special variables that are part of a function’s signature. When a function has parameters, you can provide it with concrete values for those parameters. Technically, the concrete values are called arguments, but in casual conversation, people tend to use the words parameter and argument interchangeably for either the variables in a function’s definition or the concrete values passed in when you call a function.

Go

Непонятная поделка многомиллионной корпорации, которая популярна среди людей с особым складом ума. Яркий пример можно найти здесь:

Как так получается, что идентификатор id стал аргументом?

Python

Назван в честь Летающего цирка Монти Пайтона и пишут на нём такие же клоуны.

Хоть документации приведено различие между этими терминами, но это приводит к дублированию информации и плодит недопонимание:

Параметры

Аргументы

PHP

Personal Home Page - язык для домашних страничек пользователей, который за неимением альтернатив используют большинство сайтов.

Читаем про допустимость запятой после параметров и вдруг видим аргументы.

JavaScript

Язык, которому место на свалке истории, но жадным капиталистам производителям браузеров наплевать на развитие.

Аргументы по умолчанию внезапно названы параметрами:

Dart

Разрабатывается как строго типизированная замена JavaScript, но не расчитывайте на то, что он появится в браузерах.

Документации мало, но я нашёл к чему докопаться.

Named parameters - все параметры именованые, если мы различаем термины, то нужно named argument.

When calling a function, you can specify named arguments using paramName: value.

Почему для named arguments используется paramName? Если мы различаем термины, то это ошибка.

To define a default value for a named parameter besides

Здесь не использовали более точную формулировку default argument for a named parameter чтоб не получилось масло маслянное.

const

void A(const int B){
	B++; // Ошибка! Аргумент B объявлен как const
}
void main(){
	A(5);
}

Начальные значения аргументов

string A = "Москве";

void B(string C, string D="гараж", string E=A){
	print(C+" "+D+" в "+E+"\n");
}

void main(){
	B("Продам"); // Выведет: Продам гараж в Москве
	B("Продам", "квартиру"); // Выведет: Продам квартиру в Москве
	B("Пропью", "деньги", "кабаке"); // Выведет: Пропью деньги в кабаке
}

Аргументы по ссылке

in

void A(string& in B){
	print(B);
}
string C = "Привет!";
void main {
	A(C); // В функцию будет передана ссылка на переменную, копирование памяти не произойдёт.
	A("Допустимо передавать значение напрямую без помещения в переменную");
}

const

void A(string& in B, const string& in C){
	B = "Ошибка! Запрещено присваивать значение входящим ссылкам!";
	C = "Ошибка! Аргумент C объявлен как const"
}

out

int divide(int a, int b, int& out remainder) {
    remainder = a % b; // записываем остаток от деления в переменную для выхода
    return a / b; // возвращаем результат деления
}

void main() {
    int remainder;
    int result = divide(10, 3, remainder);
}

int divide(int a, int b, int& out remainder = void) {
    remainder = a % b; // записываем остаток от деления в переменную для выхода
    return a / b; // возвращаем результат деления
}

void main() {
    int result = divide(10, 3);
}

inout

funcdef void A(); // Объявляем сигнатуру функции. Читайте ниже.
void B(){
	print("Функция вызвана по ссылке");
} 
void C(A& D){
	D(); // Вызываем функцию, переданную по ссылке
};
void main(){
	C(@B); // Передаём функцию по ссылке
}

funcdef

funcdef void A(string); // Объявляем сигнатуру функции

void B(string C) { // Объявляем функцию, подходящую под сигнатуру
	print(C);
}

void D(A& E) { // Объявляем функцию, которая принимает функцию, подходящую под сигнатуру
	E("Вызываем функцию, переданную по ссылке");
}

void main(){
	A@ F = @B; // Объявляем переменную где тип является сигнатурой функции
	D(@F); // Передаём переменную в функцию
}

Перегрузка

void Log(string Msg){
	DisplayTimedTextToPlayer(GetLocalPlayer(), 0, 0, 60, Msg);
}
void Log(int Msg){
	DisplayTimedTextToPlayer(GetLocalPlayer(), 0, 0, 60, formatInt(Msg));
}

void main(){
	Log("1"); // Будет вызвана: void Log(string Msg)
	Log(1); // Будет вызвана: void Log(int Msg)
}

Приведение типов

void A(int64 B){
	print(B);
}
void main(){
	A(1); // Передаём числовой литерал, который расценивается как int32
}

const

void A(int B){}
void A(const int B){}
void main(){
	A(1); //Ошибка! Две функции подходят под условие перегрузки
}

Ссылки

void A(int B){}
void A(int& B){}
void main(){
	A(1); //Ошибка! Две функции подходят под условие перегрузки
}

Числа

Поиск функции

void A(int8 B, int16 C, int32 D){}; // Кандидат 1
void A(int32 B, int16 C, int8 D){}; // Кандидат 2
void A(string B, int16 C, int8 D){}; // Кандидат 3

A(int16(1), int16(1), int32(1));

A(int16(1), uint16(1), int16(1));

Анонимные функции

funcdef bool Comparator(int a, int b); // Объявляем сигнатуру функции сравнения

bool Compare(int a, int b, Comparator @comparator){ // Объявляем функцию которая сравнивает два числа используя функцию сравнения
	return comparator(a,b);
}

void main() {
	// Сравниваем числа и ложим результат в переменные
    bool result1 = Compare(1, 2, function(a,b){ return a == b; });
    bool result2 = Compare(3, 4, function(a,b){ return a != b; });
}

Неоднозначность

funcdef void A(int);
funcdef void B(float);
void Overloaded(A@) {}
void Overloaded(B@) {}

void main()  {
    Overloaded(function(int a) {});
}