mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-21 13:45:44 +01:00
31 lines
1.6 KiB
ReStructuredText
31 lines
1.6 KiB
ReStructuredText
purchaseServer() Netscript Function
|
|
===================================
|
|
|
|
.. js:function:: purchaseServer(hostname, ram)
|
|
|
|
:param string hostname: Hostname of the purchased server
|
|
:param number ram: Amount of RAM of the purchased server. Must be a power of 2. Maximum value of :js:func:`getPurchasedServerMaxRam`
|
|
:RAM cost: 2.25 GB
|
|
|
|
Purchased a server with the specified hostname and amount of RAM.
|
|
|
|
The *hostname* argument can be any data type, but it will be converted to a string and have whitespace removed. Anything that resolves to an empty string will
|
|
cause the function to fail. If there is already a server with the specified hostname, then the function will automatically append
|
|
a number at the end of the *hostname* argument value until it finds a unique hostname. For example, if the script calls
|
|
*purchaseServer("foo", 4)* but a server named "foo" already exists, the it will automatically change the hostname to "foo-0". If there is already
|
|
a server with the hostname "foo-0", then it will change the hostname to "foo-1", and so on.
|
|
|
|
Note that there is a maximum limit to the amount of servers you can purchase.
|
|
|
|
Returns the hostname of the newly purchased server as a string. If the function fails to purchase a server, then it will return an
|
|
empty string. The function will fail if the arguments passed in are invalid, if the player does not have enough money to purchase
|
|
the specified server, or if the player has exceeded the maximum amount of servers.
|
|
|
|
Example::
|
|
|
|
ram = 64;
|
|
hn = "pserv-";
|
|
for (i = 0; i < 5; ++i) {
|
|
purchaseServer(hn + i, ram);
|
|
}
|