Difference between revisions of "Keyvalstr"

From OpenEUO
Jump to: navigation, search
m
m
Line 1: Line 1:
''keyvalstr implemented, but undocumented''
+
== Calling Convention ==
 +
Call
 +
local r = sl.keyvalstr(arg)
 +
Args
 +
arg is a table
 +
Results
 +
r is a string
 +
 
 +
== Usage Example ==
 +
 
 +
local s = {[11]=16}
 +
local t = { [0]='finale', alice='joker', [s]='88'}
 +
local r = sl.keyvalstr(t)
 +
print(r)
 +
 
 +
--> 'table keys:values = {'
 +
--> '0:finale,'
 +
--> 'alice:joker,'
 +
--> 'table: 0x01532360:88,'
 +
--> '}'
 +
 
 +
== Description ==
 +
 
 +
The helper function keyvalstr returns a human readable string composed of the keys and values found in its sole argument. The keys and values are converted to strings before insertion into the resultant table.  If the sole argument is not a table, then the string 'not a table' is returned. ''future versions of the library may alter the output slightly. the key* helpers aren't intended to convert data into a [[dostring]] compatible format; further additions to the library will address that need.''
  
 
== See Also ==
 
== See Also ==
  
 
* [http://www.easyuo.com/openeuo/wiki/index.php/Simplelib simplelib]
 
* [http://www.easyuo.com/openeuo/wiki/index.php/Simplelib simplelib]
 +
 +
* [[keys]]
 +
 +
* [[keystr]]

Revision as of 14:52, 2 November 2010

Calling Convention

Call

local r = sl.keyvalstr(arg)

Args

arg is a table

Results

r is a string

Usage Example

local s = {[11]=16}
local t = { [0]='finale', alice='joker', [s]='88'}
local r = sl.keyvalstr(t)
print(r)
--> 'table keys:values = {'
--> '0:finale,'
--> 'alice:joker,'
--> 'table: 0x01532360:88,'
--> '}'

Description

The helper function keyvalstr returns a human readable string composed of the keys and values found in its sole argument. The keys and values are converted to strings before insertion into the resultant table. If the sole argument is not a table, then the string 'not a table' is returned. future versions of the library may alter the output slightly. the key* helpers aren't intended to convert data into a dostring compatible format; further additions to the library will address that need.

See Also