ParamDelimiter

Syntax Main.ParamDelimiter(delimiter)

Description Sets PCScript's parameter delimiter to the specified character. This method affects PCScript commands for the current PopChart only.

The parameter delimiter divides different parameters from each other inside of PCScript methods. By default, the parameter delimiter for PCScript is a comma , . This can cause problems when you are trying to pass strings that have commas in them. The Main.ParamDelimiter method lets you change the delimiter to something else.

The usefulness of this method is illustrated in Example 5.5. In this example, we attempt to name a category Fred, Barney, and Wilma. Of course, there would be no problem naming the category, since Categories are delimited with an item delimiter instead of a parameter delimiter. However, the problem arises when we try to create a drill-down item. Normally, PopChart Server would think that we were specifying three different parameters—Fred, Barney, and and Wilma. But since we set the delimiter to an asterisk *, we are able to properly pass the category name. Note that Gus and Matilda, the other category names, are delimited by the asterisk *.

Important: Unless you change the item delimiter using the Main. ItemDelimiter method, do not change the parameter delimiter to a semi-colon ; . This character is reserved for delimiting data items.

Parameters Main.ParamDelimiter accepts the following parameters.

delimiter

char

The character that will delimit parameters for this PCScript command string.

Example 5.5 Changing the Parameter Delimiter

Main.ParamDelimiter(*) 

graph.Categories(Fred, Barney, and Wilma * Gus * Matilda) 

graph.Series(Apples, Oranges, and Pears * 67 * 89 * 93) 

graph.DDEnable(Fred, Barney, and Wilma * 1-3 * http://fruitstocks.com)