=====SaveNumber=====

//(Information and examples taken from the DroidScript documentation)//

====Description====

The **SaveNumber** method saves a numeric **value** to the user's storage space under **valueName**. Use this method when saving and loading user preferences.

The third parameter **id** is an optional text parameter and allows sharing of data across multiple Apps when the same id is used by both apps.

The third parameter is only useful for sharing data between apps run in the DroidScript IDE. It cannot be used to share data between standalone apps created with the apk-builder.

<code> app.SaveNumber( valueName, value, id );</code>

See also [[built_in:load_number|LoadNumber]]

----

====Example====

<code javascript>

function OnStart()
{
  num = app.LoadNumber( "MyNumber", 42 );
  app.ShowPopup( num );

  app.SaveNumber( "MyNumber", num+1 );
}   

</code>
==== APK ==== 

When you use SaveNumber while running in the DroidScript app, the value will be stored in DroidScript.  

When you first create your APK the number you have saved will **not** be bundled with the apk.  

The first time the customer runs the app, the default value will be returned from app.LoadNumber.  

If the customer installs an update to the app later, any values the app has saved will not be lost.