NameValuePairs - Global

The NameValuePairs script include provides methods to convert between maps and strings representing the name/value pairs in the map.

The string form is: <name> = <value>, <name> = <value, ... where <name> is a string name, optionally surrounded by double quotes (Microsoft-style), and <value> is a string value, also optionally surrounded by double quotes.

The following are all examples of valid name/value strings:

• name = value
• name = "My Value", name = value
• "My Name = this" = "My Value", "My Value, all the time", name = value
• "My Name" = "This" "name""", name = value

In the third example, the quoted values contain equals and commas. In the fourth example, the quoted value contains a quote.

Instances have the following properties initialized:

• map: The map (JavaScript object being used as a hashmap) form of the name/value pairs, with Microsoft-style quotes removed
• string: The string form of the name/value pairs, with Microsoft-style quoting.

Use with any server-side script where you need convert name/value pairs between maps and strings.

NameValuePairs - NameValuePairs(String stringForm)

Creates an instance of the class initialized with the specified string.

Table 1. Parameters

Name	Type	Description
stringForm	String	The values to use when creating the object.

NameValuePairs - NameValuePairs(Object mapForm)

Creates an instance of the class initialized with the specified hash map.

Table 2. Parameters

Name	Type	Description
mapForm	Object	The map to use when creating the object.

NameValuePairs - mapToString()

Produces this.string from this.map.

Table 3. Parameters

Name	Type	Description
None

Table 4. Returns

Type	Description
void

NameValuePairs - quotify(Object value)

If the specified value contains double quotes, equals, commas, or spaces, this method surrounds the value with double quotes and doubles up any enclosed double quotes.

Table 5. Parameters

Name	Type	Description
value	Object	The value to process

Table 6. Returns

Type	Description
String	The value with added quotes.

NameValuePairs - stringToMap()

Produces this.map from this.string.

Table 7. Parameters

Name	Type	Description
None

Table 8. Returns

Type	Description
void