Команда COUNT

Считает записи таблицы.

Синтаксис

COUNT
[Scope] [FOR lExpression1] [WHILE lExpression2]
[TO MemVarName]
[NOOPTIMIZE]

Параметры

Scope

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

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

FOR lExpression1

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

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

WHILE lExpression2

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

TO MemVarName

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

NOOPTIMIZE

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

Комментарии

Команда COUNT подсчитывает записи в диапазоне, для которого являются истинными условия FOR или WHILE. Если установка SET TALK имеет значение ON, отображается счетчик записей.

Записи, помеченные на удаление, включаются в счет, если действует установка SET DELETE OFF.

О том, как пустые значения отражаются на работе команды COUNT, см. главу 2 "О зор языка программирования" Руководства разработчика.