Epi Info™ User Guide
Command Reference
Check Commands: CLEAR
Description
CLEAR sets the field or fields that follow the command to the missing value as if they had been left blank. The command is used to clear a previous entry when an error has been detected or a change occurs.
Note: One or more fields can be used with the CLEAR command in a single statement. Specify a group field in a CLEAR command to clear all fields contained within the group.
Syntax
CLEAR <field>
CLEAR <field1> <field2> <field3> <fieldN>
- The <field> represents the name of a field on the form. If more than one field is specified, separate each field with a single blank space.
Comments
CLEAR will delete the value only for the current record. CLEAR cannot be used in grid tables.
Examples
To try the code examples below, copy and paste the code example into the Form Designer Check Code Editor, then run the form in Enter. The code example may require specific fields to be on the form.
Example 1: The code below prevents invalid data from being saved to the current record by erasing it as soon as it is detected. The example assumes a form exists with the following field: Age (Numeric). The code below would appear in the AFTER section of the Age field.
Field Age After IF Age >= 18 THEN BEEP DIALOG "Do not include records for adults." CLEAR Age END-IF End-After End-Field
Example 2: The code below prevents an invalid date from being saved to the current record by erasing it as soon as it is detected. The example assumes a form exists with the following fields: DOB (Date) and SurveyDate (Date). The code below would appear in the AFTER section of the SurveyDate field.
Field SurveyDate After IF (DOB > SurveyDate) OR (SurveyDate > SYSTEMDATE) THEN CLEAR DOB SurveyDate DIALOG "Invalid date detected. Please try again." TITLETEXT="Error" END-IF End-After End-Field
Example 3: The code below enables or disables a field representing the patient’s pregnancy status based on the value selected for the patient’s sex. If value of PatientSex is “Male”, the CLEAR command is used to erase any value that might have been accidentally entered for the PregnancyStatus field. This example assumes a form exists with the following fields: PatientSex (Legal Value) and PregnancyStatus (Yes-No). The code below would appear in the AFTER section of the PatientSex field.
Field PatientSex After IF PatientSex = "Male" THEN CLEAR PregnancyStatus DISABLE PregnancyStatus ELSE ENABLE PregnancyStatus END-IF End-After End-Field