Settings.load - Revision history

Bomb Bloke: Code fix.

2016-06-10T03:14:09Z

Code fix.

Bomb Bloke: .settings is loaded "in addition to" the defaults, as opposed to "instead of"

2016-06-10T02:56:37Z

.settings is loaded "in addition to" the defaults, as opposed to "instead of"

Bomb Bloke: Type templates

2016-06-10T02:37:18Z

Type templates

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=settings.load |args=string path |returns=boolean success |api=settings |addon=ComputerCraft |desc=Loads settings from the..."

2016-06-10T02:30:05Z

Created page with "{{lowercase}} {{Function |name=settings.load |args=string path |returns=boolean success |api=settings |addon=ComputerCraft |desc=Loads settings from the..."

New page

{{lowercase}}
{{Function
|name=settings.load
|args=[[string]] path
|returns=[[boolean_(type)|boolean]] success
|api=settings
|addon=ComputerCraft
|desc=Loads settings from the specified file. Any settings that've already been loaded (eg [[Settings_(API)#Default_Settings|the defaults]]) will not be affected unless the target file contains entries with the same names.<br><br>

If a file titled ".settings" is [[settings.save|saved]] to the root of a computer's drive, it will be automatically loaded on startup (without need to call this function manually).
|examples=
{{Example
|desc=Loads all settings specified within the file "mySettings", displaying before / after lists.
|code=print("Initial loaded settings:\n")
[[textutils.pagedTabulate]]( [[settings.getNames]]() )

settings.load("mySettings")

print("Resulting loaded settings:\n")
[[textutils.pagedTabulate]]( [[settings.getNames]]() )
}}
}}

{{SettingsAPIFunctions}}

[[Category:API_Functions]]

@@ Line 17: / Line 17: @@
   settings.load("mySettings")
-  print("Resulting loaded settings:\n")
+  print("\nResulting loaded settings:\n")
   [[textutils.pagedTabulate]]( [[settings.getNames]]() )
 }}

@@ Line 8: / Line 8: @@
 |desc=Loads settings from the specified file. Any settings that've already been loaded (eg [[Settings_(API)#Default_Settings|the defaults]]) will not be affected unless the target file contains entries with the same names.<br><br>
-If a file titled ".settings" is [[settings.save|saved]] to the root of a computer's drive, it will be automatically loaded on startup (without need to call this function manually).
+If a file titled ".settings" is [[settings.save|saved]] to the root of a computer's drive, it will be automatically loaded on startup after the default settings (without need to call this function manually).
 |examples=
 {{Example

@@ Line 2: / Line 2: @@
 {{Function
 |name=settings.load
-|args=[[string]] path
+|args={{Type|string}} path
-|returns=[[boolean_(type)|boolean]] success
+|returns={{Type|boolean}} success
 |api=settings
 |addon=ComputerCraft