[line 27]
This class defines a container to hold gathered form-data.
The idea behind this is fairly simple: normally every form-widget has it's own exotic set of rules concerning the representation of it's values. A group of checkboxes for example not only returns nothing when not box is checked, but isn't even included in the resultset in that case. Considering that a multi-select, which is merely a different representation for this, is not only inlcuded, but also has a value (an empty array), this is quite bizarre.
A FormValueSet is supposed to streamline this, by applying the same rules to every value-bearing widget. When calling a FormValueSet for a form like $valueSet->htmlnameofwidget you should get the following defined answers: widget is not in form/is disabled => null widget is empty => '' or array() widget has selected value(s) => 'string' or Array(String, String, ...)
Widgets are supposed to return according values.
By this all voodoo-knowledge about when which widget returns what should be obsolete.
