char* aw_string (AW_ATTRIBUTE a)

DESCRIPTION

Returns a string attribute.

NOTES

The contents of the string buffer returned are only valid immediately after the call to aw_string and may be changed by subsequent calls into the SDK.   Therefore an application should save a copy of the string attribute into its own local buffer if it wishes to hold on to the string value for an extended period of time.

EXAMPLE

/* Keep track of the name of the most recent avatar to enter the scene */

char last_avatar_name[AW_MAX_ATTRIBUTE_LENGTH + 1];

void avatar_add (void)
{

  strcpy (last_avatar_name, aw_string (AW_AVATAR_NAME));

}

aw_event_set (AW_EVENT_AVATAR_ADD, avatar_add);
aw_state_change ();
for (;;)
  if (aw_wait (1000))
    break;