Title | if command versus if qualifier | |
Author | Jeremy B. Wernow, StataCorp |
A common mistake is to use the if command as the argument. This is incorrect Stata syntax. The if command was designed to be used with a single expression (often a local macro) inside programs and do-files. Using this command incorrectly results in the evaluation of the expression using only the first observation of the variable. The same behavior applies for the while command.
. list +---+ | x | |---| 1. | 1 | 2. | 1 | 3. | 2 | 4. | 3 | 5. | 2 | |---| 6. | 3 | 7. | 1 | 8. | 2 | 9. | 1 | 10. | 3 | +---+ if x == 3 { replace x = 4 } . list +---+ | x | |---| 1. | 1 | 2. | 1 | 3. | 2 | 4. | 3 | 5. | 2 | |---| 6. | 3 | 7. | 1 | 8. | 2 | 9. | 1 | 10. | 3 | +---+
At first glance, one would wonder why this did not work. From a logical viewpoint, there is nothing wrong with the command. As mentioned above, Stata was designed to evaluate only a single expression for the if command, so it is evaluated only for the first observation, x = 1.
if x == 1 { replace x = 4 } (10 real changes made) . list +---+ | x | |---| 1. | 4 | 2. | 4 | 3. | 4 | 4. | 4 | 5. | 4 | |---| 6. | 4 | 7. | 4 | 8. | 4 | 9. | 4 | 10. | 4 | +---+
This is obviously not what the user intended. The solution to this problem is often to rewrite the command using if as a qualifier rather than as a command. As a qualifier, if will evaluate each observation as the command passes over the data.
. replace x = 4 if x == 3 . replace x = 4 if x == 1
As noted earlier, the same behavior will be seen when using the while command.
. list +---+ | x | |---| 1. | 1 | 2. | 1 | 3. | 2 | 4. | 3 | 5. | 2 | |---| 6. | 3 | 7. | 1 | 8. | 2 | 9. | 1 | 10. | 3 | +---+ while x == 3 { replace x = 4 } . list +---+ | x | |---| 1. | 1 | 2. | 1 | 3. | 2 | 4. | 3 | 5. | 2 | |---| 6. | 3 | 7. | 1 | 8. | 2 | 9. | 1 | 10. | 3 | +---+ while x == 1 { replace x = 4 } (10 real changes made) . list +---+ | x | |---| 1. | 4 | 2. | 4 | 3. | 4 | 4. | 4 | 5. | 4 | |---| 6. | 4 | 7. | 4 | 8. | 4 | 9. | 4 | 10. | 4 | +---+
Learn
Free webinars
NetCourses
Classroom and web training
Organizational training
Video tutorials
Third-party courses
Web resources
Teaching with Stata
© Copyright 1996–2024 StataCorp LLC. All rights reserved.
×
We use cookies to ensure that we give you the best experience on our website—to enhance site navigation, to analyze usage, and to assist in our marketing efforts. By continuing to use our site, you consent to the storing of cookies on your device and agree to delivery of content, including web fonts and JavaScript, from third party web services.
Cookie Settings
Last updated: 16 November 2022
StataCorp LLC (StataCorp) strives to provide our users with exceptional products and services. To do so, we must collect personal information from you. This information is necessary to conduct business with our existing and potential customers. We collect and use this information only where we may legally do so. This policy explains what personal information we collect, how we use it, and what rights you have to that information.
These cookies are essential for our website to function and do not store any personally identifiable information. These cookies cannot be disabled.
This website uses cookies to provide you with a better user experience. A cookie is a small piece of data our website stores on a site visitor's hard drive and accesses each time you visit so we can improve your access to our site, better understand how you use our site, and serve you content that may be of interest to you. For instance, we store a cookie when you log in to our shopping cart so that we can maintain your shopping cart should you not complete checkout. These cookies do not directly store your personal information, but they do support the ability to uniquely identify your internet browser and device.
Please note: Clearing your browser cookies at any time will undo preferences saved here. The option selected here will apply only to the device you are currently using.