int aw_world_attribute_get (int attribute, int* read_only, char* value)

DESCRIPTION

Retrieves the value of an individual world attribute.

CALLBACK

None (returns immediately)

NOTES

This method is new in Active Worlds 3.1 and requires at least SDK build 18.

This method was added to make the implementation of a "remote atdump" utility easier and is of limited use to the general SDK programmer.  In particular, meaningful values for the attribute argument correspond only to entries in a world server attribute dump file and are not otherwise documented; they do not correspond to the various AW_WORLD_ attributes defined within the SDK.

SDK applications that wish to query the values of specific world attributes should continue to do so by using the aw_int, aw_bool, aw_float, and aw_string routines.

EXAMPLE

FILE* fp;
int   rc;
int   i;
int   read_only;
char  string[256];
/* implement a simplistic remote atdump utility */
fp = fopen ("atdump.txt", "w");
for (i = 0; i < 100; i++) {
  if (i == 22)
    /* old-style (binary) object password, don't dump */     
    continue;
  if (rc = aw_world_attribute_get (i, &read_only, string))
    continue;
  if (read_only)
    continue;
  fprintf (fp, "%d %s\n", i, string);
}
fclose (fp);