int aw_citizen_attributes_by_number (int citizen)

DESCRIPTION

Returns attributes associated with a citizen number.

CALLBACK

AW_CALLBACK_CITIZEN_ATTRIBUTES

NOTES

If citizen corresponds to a valid citizen, one or more of 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

Note that all attributes are returned only if this instance is owned by the universe root account (citizen #1).  Otherwise, only AW_CITIZEN_NAME and AW_CITIZEN_URL are returned.

If you are using aw_citizen_attributes_by_number in asynchronous mode, you should check the value of AW_CITIZEN_NUMBER within the callback to verify that it is the same number that you queried.

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.

If the specified name does not exist, RC_NO_SUCH_CITIZEN will be returned and all attributes except AW_CITIZEN_NUMBER will be undefined.

EXAMPLE

if (aw_citizen_attributes_by_number (1)) 
  puts ("No such citizen");
else
  printf ("Citizen #1's name is %s\n", aw_string (AW_CITIZEN_NAME));

SEE ALSO

aw_citizen_attributes_by_name
aw_citizen_add
aw_citizen_change
aw_citizen_delete
aw_citizen_next
aw_citizen_previous