1 files changed, 29 insertions, 0 deletions
diff --git a/lib/sol2/examples/source/docs/preparing_environments.cpp b/lib/sol2/examples/source/docs/preparing_environments.cpp
new file mode 100644
index 0000000..f3820f7
--- /dev/null
+++ b/lib/sol2/examples/source/docs/preparing_environments.cpp
@@ -0,0 +1,29 @@
+#define SOL_ALL_SAFETIES_ON 1
+#include <sol/sol.hpp>
+
+int main (int, char*[]) {
+	sol::state lua;
+	lua.open_libraries();
+	sol::environment my_env(lua, sol::create);
+	// set value, and we need to explicitly allow for 
+	// access to "print", since a new environment hides 
+	// everything that's not defined inside of it
+	// NOTE: hiding also hides library functions (!!)
+	// BE WARNED
+	my_env["var"] = 50;
+	my_env["print"] = lua["print"];
+
+	sol::environment my_other_env(lua, sol::create, lua.globals());
+	// do not need to explicitly allow access to "print",
+	// since we used the "Set a fallback" version 
+	// of the sol::environment constructor
+	my_other_env["var"] = 443;
+
+	// output: 50
+	lua.script("print(var)", my_env);
+
+	// output: 443
+	lua.script("print(var)", my_other_env);
+
+	return 0;
+}
+\ No newline at end of file