Xan: Created page with "{{SDK added in|version=2.1|sdk=13|world=|universe=|browser=}} NOTOC int aw_init (int `build`) ==Description== Initializes the SDK. ==Callback== None (returns immediately) ==Notes== This method or aw_init_bind must be called once before any other methods in the API. It will do an implicit aw_term if the SDK has already been successfully initialized. Thus, there is no need to call aw_term for each additional call to this method, as there is n..."

2025-04-07T19:23:02Z

Created page with "{{SDK added in|version=2.1|sdk=13|world=|universe=|browser=}} __NOTOC__ int aw_init (int <var>build</var>) ==Description== Initializes the SDK. ==Callback== None (returns immediately) ==Notes== This method or aw_init_bind must be called once before any other methods in the API. It will do an implicit aw_term if the SDK has already been successfully initialized. Thus, there is no need to call aw_term for each additional call to this method, as there is n..."

New page

{{SDK added in|version=2.1|sdk=13|world=|universe=|browser=}}

__NOTOC__

int aw_init (int <var>build</var>)

==Description==
Initializes the SDK.

==Callback==
None (returns immediately)

==Notes==
This method or [[aw_init_bind]] must be called once before any other methods in the API. It will do an implicit [[aw_term]] if the SDK has already been successfully initialized. Thus, there is no need to call [[aw_term]] for each additional call to this method, as there is no reference count.

If successful then the tick count returned by [[aw_tick]] is reset to 0 and the pseudo-random number generator used by [[aw_random]] is seeded.

==Arguments==
;build:AW_BUILD in Aw.h defines the build of Aw.dll (or libaw_sdk.so for Linux) it was distributed with and should be passed as the value of this argument.

==Argument attributes==
None

==Return values==
;[[SDK Reason Codes#RC_SUCCESS|RC_SUCCESS]]:
;[[SDK Reason Codes#RC_VERSION_MISMATCH|RC_VERSION_MISMATCH]]:Aw.h and Aw.dll (or libaw_sdk.so for Linux) are from different builds of the SDK.

==Returned attributes==
None

==Usage==
#include "Aw.h"
#include "[[Reason.h]]"

int main (int argc, char *argv[])
{
if ([[aw_init]] (AW_BUILD) != [[SDK Reason Codes#RC_SUCCESS|RC_SUCCESS]])
{
printf ("Build #%d of Aw.dll is required to run this bot.\n", AW_BUILD);
return 1;
}

/* ... */

[[aw_term]] ();
return 0;
}

==See also==
*[[SDK_Application_Structure|Application structure]]
*[[aw_init_bind]]
*[[aw_random]]
*[[aw_term]]
*[[aw_tick]]

[[Category: SDK Methods|I]]

Aw init - Revision history