Команда SUM

Суммирует все или только заданные числовые поля в таблице, выбранной в данный момент.

Синтаксис

SUM [eExpressionList]
[Scope] [FOR lExpression1] [WHILE lExpression2]
[TO MemVarNameList | TO ARRAY ArrayName]
[NOOPTIMIZE]

Параметры

eExpressionList

Задает одно или несколько полей или выражений полей, которые требуется п осуммировать. Если список выражений полей опущен, суммируются все числовые поля.

Scope

Задает диапазон записей, включаемых в общую сумму. Диапазон определяется сле ующими предложениями: ALL, NEXT nRecords, RECORD nRecordNumber и REST. Подробнее о предложения диапазона см. тему Предложения диапазона или главу 2 "Обзор языка программирования" Руководства разработчика.

По умолчанию областью действия команды SUM являются все записи (предложение ALL).

FOR lExpression1

Задает суммирование только тех записей, для которых логическое условие lExpression1 имеет значение "истина" (.T.). Применение предложения FOR позволяет выполнять условное суммирование записей, отсеивая ненужные.

Технология Rushmore оптимизирует команду SUM ... FOR, если lExpression1 является оптимизируемым выражением. В целях получения наивысшей производитель ости используйте в предложении FOR оптимизируемое выражение. Подробнее об оптимизации по технологии Rushmore см. темы SET OPTIMIZE и Основы технологии Rushmore или главу 17 " Оптимизация приложений" Руководства разработчика.

WHILE lExpression2

Задает условие, в соответствии с которым записи из текущей таблицы включаются в общую сумму, пока логическое выражение lExpression2 остается истинным (.T.).

TO MemVarNameList

Сохраняет каждую сумму в переменной памяти. Если в списке MemVarNameList указана несуществующая переменная памяти, Visual FoxPro автоматически создает ее. Разделяйте имена переменных в списке запятыми.

TO ARRAY ArrayName

Сохраняет суммы в массиве переменных памяти. Если в команде SUM задан есуществующий массив, Visual FoxPro автоматически создает его. Если массив существует, но слишком мал для того, чтобы вместить все полученные суммы, его размер автоматически увеличивается надлежащим образом.

NOOPTIMIZE

Блокирует оптимизацию команды SUM по технологии Rushmore. Подробнее см. темы SET OPTIMIZE и Основы технологии Rushmore или главу 17 " Оптимизация приложений" Руководства разработчика.