Merge pull request #3 from sfaqer/feature/lambdas

Добавлена поддержка лямбда выражений в функциональных интерфейсах
sfaqer · Mar 28, 2023 · 83fdf4d · 83fdf4d
2 parents 6189c4f + 5e348d4
commit 83fdf4d
Show file tree

Hide file tree

Showing 25 changed files with 906 additions and 41 deletions.
diff --git a/README.md b/README.md
@@ -317,8 +317,13 @@ class ИтераторЗначениеСоответствие {
 //  начиная с того на который указывает итератор
 //
 // Параметры:
-//   Действие - Действие - Делегат на процедуру с одном параметром
+//   Действие - Действие - Делегат на процедуру с одним параметром
 //    которая принимает элемент коллекции
+//            - Строка - Лямбда выражение с одним параметром
+//    которая принимает элемент коллекции
+//
+// Пример:
+//    Итератор.ДляКаждогоОставшегося(Элемент -> Сообщить(Элемент));
 //
 Процедура ДляКаждогоОставшегося(Действие) 
 ```
@@ -425,9 +430,14 @@ class ИтераторЗначениеСоответствие {
 // Выполняет переданный алгоритм для каждого элемента коллекции
 //
 // Параметры:
-//   Алгоритм - Действие - Делегат на процедуру с одном параметром, в который
+//   Алгоритм - Действие - Делегат на процедуру с одним параметром, в который
+//    будет передан элемент коллекции
+//            - Строка - Лямбда выражение с одним параметром, в который будет
 //    будет передан элемент коллекции
 //
+// Пример:
+//    Обходимое.ДляКаждого("Элемент -> Сообщить(Элемент)");
+//
 Процедура ДляКаждого(Алгоритм) 
 ```
 ---
@@ -580,6 +590,10 @@ class ИтераторЗначениеСоответствие {
 //
 // Параметры:
 //   Предикат - Действие - Делегат на функцию с одним параметром, в которой передаётся элемент коллекции
+//            - Строка - Лямбда выражение с одним параметром, в который передаётся элемент коллекции
+//
+// Пример:
+//    Коллекция.УдалитьЕсли("(Элемент) -> Элемент >= 2");
 //
 //  Возвращаемое значение:
 //   Булево - Истина, если был удалён хотя бы один элемент
@@ -697,6 +711,11 @@ class ИтераторЗначениеСоответствие {
 // Параметры:
 //   Алгоритм - Действие - Делегат на функцию с одним параметром, в которую передаётся
 //    элемент списка, и которая возвращает новое значение элемента
+//            - Строка - Лямбда выражение с одним параметром, в который передаётся
+//    элемент списка, и которая возвращает новое значение элемента
+//
+// Пример:
+//    Список.ЗаменитьВсе("Элемент -> Элемент + 1");
 //
 Процедура ЗаменитьВсе(Алгоритм) 
 ```
@@ -708,12 +727,28 @@ class ИтераторЗначениеСоответствие {
 //
 // Параметры:
 //   СравнениеЗначений - Действие - Делегат на функцию с двумя параметрами
-//    в которую передаются 2 элемента коллекции, и которая возвращает число:
-//     1 - Если первый элемент больше
-//     -1 - Если второй элемент больше
-//     0 - Если элементы равны
+//    в которую передаются 2 элемента коллекции, и которая возвращает число
+//      1 - Если первый элемент больше,
+//     -1 - Если второй элемент больше,
+//      0 - Если элементы равны
+//                     - Строка - Лямбда выражение с двумя параметрами
+//    в которую передаются 2 элемента коллекции, и которая возвращает число
+//      1 - Если первый элемент больше,
+//     -1 - Если второй элемент больше,
+//      0 - Если элементы равны
+//
+// Пример:
+//    Список.Сортировать("Первый, Второй -> {
+//        | Если Первый > Второй Тогда
+//        |     Возврат 1;
+//        | ИначеЕсли Второй > Первый Тогда
+//        |     Возврат -1;
+//        | Иначе
+//        |     Возврат 0;
+//        | КонецЕсли;
+//        |}"
+//    );
 //
-Процедура Сортировать(СравнениеЗначений) 
 ```
 
 ### УдалитьПоИндексу
@@ -783,7 +818,11 @@ class ИтераторЗначениеСоответствие {
 //
 // Параметры:
 //   Алгоритм - Действие - Делегат на метод с двумя параметрами который будет выполнятся
-//    в первый параметр передаёт ключ во второй значение
+//    в первый параметр передаётся ключ во второй значение
+//            - Строка - Лямбда выражение с двумя параметрами в первый параметр передаётся ключ во второй значение
+//
+// Пример:
+//     Карта.ДляКаждого("(Ключ, Значение) -> Сообщить(СтрШаблон(""Ключ: %1, Значение:2"", Ключ, Значение))");
 //
 Процедура ДляКаждого(Алгоритм) 
 ```
@@ -935,7 +974,12 @@ class ИтераторЗначениеСоответствие {
 // Параметры:
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую передаются ключ
-//    и Опциональный от текущего значения ключа (пустой если ключа нет).
+//    и Опциональный от текущего значения ключа (пустой если ключа нет)
+//                         - Строка - Лямбда выражение с двумя параметрами в которую будут переданы ключ
+//    и Опциональный от текущего значения ключа (пустой если ключа нет)
+//
+// Пример:
+//    Карта.ВычислитьБезусловно("Ключ", "(Ключ, Значение) -> ?(Значение.Пустой(), Истина, Ложь)")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -954,6 +998,10 @@ class ИтераторЗначениеСоответствие {
 // Параметры:
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияНазначения - Действие - Делегат на функцию с одним параметром, в которую передаётся переданный ключ
+//                     - Строка - Лямбда выражение с одним параметром в который будет передан переданный ключ
+//
+// Пример:
+//    Карта.ВычислитьЕслиОтсутствует("Ключ", "(Ключ) -> СтрДлина(Ключ)")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа если оно было вычислено, или текущее значение ключа
@@ -974,6 +1022,18 @@ class ИтераторЗначениеСоответствие {
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую передаются ключ
 //    и текущее значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами, в которые передаются ключ и текущее
+//    значение ключа
+//
+// Пример:
+//    Карта.ВычислитьЕслиПрисутствует("Ключ", "(Ключ, Значение) -> {
+//        |   Если Ключ = ""Ключ"" Тогда
+//        |       Возврат СтрДлина(Значение.Получить());
+//        |   Иначе
+//        |       Возврат Неопределенно;
+//        |   КонецЕсли;
+//        |}"
+//    );
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -992,8 +1052,17 @@ class ИтераторЗначениеСоответствие {
 // Параметры:
 //   Ключ - Произвольный - Ключ, значения для которого требуется объединить
 //   Значение - Произвольный - Новое значение ключа
-//   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами со старым и новым 
-//    значением ключа
+//   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами в которые передаются
+//    существующее и новое значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами в которые передаются 
+//    существующее и новое значение ключа
+//
+// Пример:
+//    Карта.Слить("Ключ", 4, "(СуществующееЗначение, НовоеЗначение) -> 
+//        | Возврат ?(НовоеЗначение > СуществующееЗначение,
+//        |     НовоеЗначение,
+//        |     СуществующееЗначение
+//        | );")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -1040,7 +1109,12 @@ class ИтераторЗначениеСоответствие {
 //
 // Параметры:
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую
-//    передаются ключ и значение карты
+//    передаются ключ и значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами, в которые передаются
+//    ключ и значение ключа
+//
+// Пример:
+//    Карта.ЗаменитьВсе("(Ключ, Значение) -> Значение + 1")
 //
 Процедура ЗаменитьВсе(ФункцияПереназначения) 
 ```
@@ -1058,4 +1132,3 @@ class ИтераторЗначениеСоответствие {
 //
 Функция Удалить(Ключ) 
 ```
-
diff --git a/packagedef b/packagedef
@@ -1,5 +1,5 @@
 Описание.Имя("collectionos")
-        .Версия("0.1.0")
+        .Версия("0.2.0")
         .Автор("Кирилл Черненко")
         .АдресАвтора("https://github.com/sfaqer")
         .Описание("Фреймворк коллекций для OneScript")
@@ -10,6 +10,7 @@
         .ВключитьФайл("package-loader.os")
         .ЗависитОт("reflector", "0.7.1")
         .ЗависитОт("fluent", "0.5.0")
+        .ЗависитОт("lambdas", "0.1.1")
         .ЗависитОт("optional")
         .РазработкаЗависитОт("1commands")
         .РазработкаЗависитОт("1testrunner")

diff --git a/src/internal/Классы/Интерфейсы/Карта.os b/src/internal/Классы/Интерфейсы/Карта.os
@@ -44,7 +44,12 @@
 // Параметры:
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую передаются ключ
-//    и Опциональный от текущего значения ключа (пустой если ключа нет).
+//    и Опциональный от текущего значения ключа (пустой если ключа нет)
+//                         - Строка - Лямбда выражение с двумя параметрами в которую будут переданы ключ
+//    и Опциональный от текущего значения ключа (пустой если ключа нет)
+//
+// Пример:
+//    Карта.ВычислитьБезусловно("Ключ", "(Ключ, Значение) -> ?(Значение.Пустой(), Истина, Ложь)")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -60,6 +65,10 @@
 // Параметры:
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияНазначения - Действие - Делегат на функцию с одним параметром, в которую передаётся переданный ключ
+//                     - Строка - Лямбда выражение с одним параметром в который будет передан переданный ключ
+//
+// Пример:
+//    Карта.ВычислитьЕслиОтсутствует("Ключ", "(Ключ) -> СтрДлина(Ключ)")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа если оно было вычислено, или текущее значение ключа
@@ -77,6 +86,18 @@
 //   Ключ - Произвольный - Ключ, для которого вычисляется значение
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую передаются ключ
 //    и текущее значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами, в которые передаются ключ и текущее
+//    значение ключа
+//
+// Пример:
+//    Карта.ВычислитьЕслиПрисутствует("Ключ", "(Ключ, Значение) -> {
+//        |   Если Ключ = ""Ключ"" Тогда
+//        |       Возврат СтрДлина(Значение.Получить());
+//        |   Иначе
+//        |       Возврат Неопределенно;
+//        |   КонецЕсли;
+//        |}"
+//    );
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -92,8 +113,17 @@
 // Параметры:
 //   Ключ - Произвольный - Ключ, значения для которого требуется объединить
 //   Значение - Произвольный - Новое значение ключа
-//   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами со старым и новым 
-//    значением ключа
+//   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами в которые передаются
+//    существующее и новое значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами в которые передаются 
+//    существующее и новое значение ключа
+//
+// Пример:
+//    Карта.Слить("Ключ", 4, "(СуществующееЗначение, НовоеЗначение) -> 
+//        | Возврат ?(НовоеЗначение > СуществующееЗначение,
+//        |     НовоеЗначение,
+//        |     СуществующееЗначение
+//        | );")
 //
 //  Возвращаемое значение:
 //   Опциональный<Произвольный> - Новое значение ключа
@@ -131,7 +161,12 @@
 //
 // Параметры:
 //   ФункцияПереназначения - Действие - Делегат на функцию с двумя параметрами, в которую
-//    передаются ключ и значение карты
+//    передаются ключ и значение ключа
+//                         - Строка - Лямбда выражение с двумя параметрами, в которые передаются
+//    ключ и значение ключа
+//
+// Пример:
+//    Карта.ЗаменитьВсе("(Ключ, Значение) -> Значение + 1")
 //
 Процедура ЗаменитьВсе(ФункцияПереназначения) Экспорт
 КонецПроцедуры

diff --git a/src/internal/Классы/Интерфейсы/Коллекция.os b/src/internal/Классы/Интерфейсы/Коллекция.os
@@ -53,6 +53,10 @@
 //
 // Параметры:
 //   Предикат - Действие - Делегат на функцию с одним параметром, в которой передаётся элемент коллекции
+//            - Строка - Лямбда выражение с одним параметром, в который передаётся элемент коллекции
+//
+// Пример:
+//    Коллекция.УдалитьЕсли("(Элемент) -> Элемент >= 2");
 //
 //  Возвращаемое значение:
 //   Булево - Истина, если был удалён хотя бы один элемент

diff --git a/src/internal/Классы/Интерфейсы/Обходимое.os b/src/internal/Классы/Интерфейсы/Обходимое.os
@@ -11,8 +11,13 @@
 // Выполняет переданный алгоритм для каждого элемента коллекции
 //
 // Параметры:
-//   Алгоритм - Действие - Делегат на процедуру с одном параметром, в который
+//   Алгоритм - Действие - Делегат на процедуру с одним параметром, в который
 //    будет передан элемент коллекции
+//            - Строка - Лямбда выражение с одним параметром, в который будет
+//    будет передан элемент коллекции
+//
+// Пример:
+//    Обходимое.ДляКаждого("Элемент -> Сообщить(Элемент)");
 //
 Процедура ДляКаждого(Алгоритм) Экспорт
 КонецПроцедуры