Admin: 1 revision imported

2021-02-07T06:53:27Z

1 revision imported

Admin: Created page with "{{infobox function |name=Compute |object=Таблица |caption=Операции над значениями |type=1 |status=2 |db=0 |exception=Неверное имя с..."

2019-08-17T08:41:14Z

Created page with "{{infobox function |name=Compute |object=Таблица |caption=Операции над значениями |type=1 |status=2 |db=0 |exception=Неверное имя с..."

New page

{{infobox function
|name=Compute
|object=[[Таблица]]
|caption=Операции над значениями
|type=1
|status=2
|db=0
|exception=Неверное имя столбца, невозможно превратить в число, строку, неверная операция
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция выполняет одну из следующих операций на значениях указанного столбца таблицы в указанном диапазоне строк таблицы: сумма, минимум, максимум, среднее, количество значений. Значения, представленные строками, могут быть превращены в числа при сложении, если необходимо. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки.

== Синтаксис ==
<code>
{{Grey|Tab.}}'''Compute'''(''<Наименование или индекс столбца (INT,STRING)>''{{Optional|,<Тип операции (STRING)>{{Default|{{Eq}}"SUM"}},<Строки превращать в числа (INT)>{{Default|{{Eq}}0}},<Индекс начальной строки (INT)>{{Default|{{Eq}}0}},<Индекс конечной строки (INT)>{{Default|{{Eq}}<Последняя строка таблицы>}},<Округление при суммировании или нахождении среднего (INT)>{{Default|{{Eq}}-1}}}}):''<Результат вычисления (NUMBER)>''
</code>

==== Аргументы ====
* <code>''<Наименование или индекс столбца (INT,STRING)>''</code> - Строковое значение аргумента задает наименование столбца, сумму значений ячеек которого необходимо получить, числовое значение задает номер этого столбца (нумерация столбца происходит с единицы).
* <code>''<Тип операции (STRING)>''</code> - {{Optional}} Задает тип выполняемой операции. Доступны следующие значения:
** '''SUM''' (по умолчанию) -- нахождение суммы значений
** '''AVG''' -- нахождение среднего значения (значения, которые не участвуют в операции (не числа) в нахождении среднего не участвуют).
** '''MAX''' -- нахождение максимального значения.
** '''MIN''' -- нахождение максимального значения.
** '''COUNT''' -- нахождение количества значений, участвующих в операции (исключаются не числовые значения (и не строковые, при наличии параметра превращения строк в числа)).

* <code>''<Строки превращать в числа (INT)>''</code> - {{Optional}} Может принимать значения: 0 (по умолчанию) -- производить операции только над числовыми значениями (как над целыми, так и над вещественными числами), 1 -- производить операции над числовыми значениями и над строковыми значениями, предварительно превращая строки в числа (фактические значения ячеек при этом не будут изменены).
* <code>''<Индекс начальной строки (INT)>''</code> - {{Optional}} Задает индекс первой строки операции. Если аргумент опущен, будет использована первая строка таблицы.
* <code>''<Индекс конечной строки (INT)>''</code> - {{Optional}} Задает индекс последней строки операции. Если аргумент опущен, будет использована последняя строка таблицы.
* <code>''<Округление при суммировании или нахождении среднего (INT)>''</code> - {{Optional}} Задает количество знаков после десятичной точки для округления значения на каждом этапе операции (по умолчанию ''-1'', опция отключена). При нахождении суммы большого числа вещественных чисел (даже если каждое число округлено до определенного количества знаков после точки), может накопиться неточность (см. [[Числа]]). Обычно такие неточности невелики и не имеют никакого значения при расчетах. Однако, для случаев, когда необходима высокая точность при вычислениях чисел с известным количеством знаков после точки, можно использовать эту опцию, которая позволяет автоматически производить округление полученного значения после каждой операции, тем самым исключив накопление неточности. Пример см. ниже.

==== Возвращаемое значение ====
Возвращается результат операции.

== Примеры ==
<pre>
//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

For i:=1 To aTab.Columns Do
Message("Среднее значение среди значений столбца "+aTab.GetColumnName(i)+": "+aTab.Compute(i,"AVG"));
EndDo;

//Будет выведено последовательно:
//"Среднее значение среди значений столбца B1: 3.16666666666666667"
//"Среднее значение среди значений столбца B2: 2.5"
//"Среднее значение среди значений столбца B3: 3.33333333333333333"
//"Среднее значение среди значений столбца B4: 21"
</pre>

=== Пример, показывающий работу опции по исключению накопления неточности ===
{{Пример суммирования с округлением}}

← Older revision	Revision as of 06:53, 7 February 2021
(No difference)

Tab.Compute - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=Compute |object=Таблица |caption=Операции над значениями |type=1 |status=2 |db=0 |exception=Неверное имя с..."