The section of the documentation to CGI.pm that you are looking at demonstrates the capture of both single parameters and groups of parameters with a common name. This is explained in the two paragraphs that follow the example.

Assuming that you have passed a parameter named `address' to your script you may access it in a number of ways, commonly:

my $value = $q->param('address');
[download]

...where $q is your CGI object. In the event that you want to put all the form parameters into a hash using the Vars method, you may access the value as follows:

my $v = $q->Vars;
my $value = $v->{'address'};
[download]

In both of these examples, the only significance of the word `address' is that it was the name of the parameter passed by the referring form (or otherwise for the purpose of demonstration).

The line with the split illustrates how, having used the Vars method, one might separate a list of values with a common parameter name into an array. This may, however, be done in the following, more natural way:

my @array_of_values = $q->param('multi_values');
[download]

...where `multi_values' is, perhaps, the name of a bunch of checkboxes in the referring form.

MB

---

---

• Are you posting in the right place? Check out Where do I post X? to know for sure.
• Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:

  <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>

• Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
• Want more info? How to link or How to display code and escape characters are good places to start.