Returns attributes of the next citizen in the citizen database.
AW_CALLBACK_CITIZEN_ATTRIBUTES
Only instances owned by the root account (citizen #1) may use aw_citizen_next.
The citizen with the next highest citizen number after the current value of AW_CITIZEN_NUMBER is returned. To scan the entire citizen database, set AW_CITIZEN_NUMBER to 0 and call aw_citizen_next repeatedly until it fails.
The following attributes are returned:
AW_CITIZEN_BETA
AW_CITIZEN_BOT_LIMIT
AW_CITIZEN_COMMENT
AW_CITIZEN_EMAIL
AW_CITIZEN_ENABLED
AW_CITIZEN_EXPIRATION_TIME
AW_CITIZEN_IMMIGRATION_TIME
AW_CITIZEN_LAST_LOGIN
AW_CITIZEN_NAME
AW_CITIZEN_NUMBER
AW_CITIZEN_PASSWORD
AW_CITIZEN_PRIVILEGE_PASSWORD
AW_CITIZEN_TOTAL_TIME
AW_CITIZEN_URL
The attributes AW_CITIZEN_COMMENT, AW_CITIZEN_ENABLED, AW_CITIZEN_TOTAL_TIME, and AW_CITIZEN_URL are new in version 3.1 and require at least build 18 of the SDK and version 3.1 of the uniserver.
/* print the names of the universe's first ten citizens */
int i;
aw_int_set (AW_CITIZEN_NUMBER, 0);
for (i = 0; i < 10; i++) {
if (aw_citizen_next ())
break;
printf ("%s\n", aw_string (AW_CITIZEN_NAME));
}
aw_citizen_add
aw_citizen_attributes_by_name
aw_citizen_attributes_by_number
aw_citizen_change
aw_citizen_delete
aw_citizen_previous