LuaSocket: Network support for the Lua language

The LuaSocket namespace

The socket namespace contains the namespace tables for all LuaSocket modules as well as function that didn't belong in any specific module, functions that are so commonly used that deserve a shortcut and a few constants.

socket.debug

This constant is set to true if the library was compiled with debug support.

socket.protect(function)

Converts a function that throws exceptions into a safe function.

Function is a function that calls try to throw exceptions.

The function an equivalent function that instead of throwing exceptoins, returns nil followed by an error message.

socket.try(ret₁, ret₂ ... ret_N)

Throws an exception in case of error.

Ret₁, ret₂ ... ret_N can be arbitrary arguments, but are usually the return values of a function call that nested with the call to try.

The function returns ret₁, ret₂ ... ret_N if ret₁ is not nil. Otherwise, calls error passing ret₂.

-- connects or throws an exception with the appropriate error message
c = socket.try(socket.connect("localhost", 80))

socket.version

This constant has a string describing the current LuaSocket version.