Basically what it does is pass along the field names of the form in a compressed hidden field (for some reason IE won't pass that along except as POST, but maybe somebody else could figure that out), then it will do one of several things, and load the result into a class variable called found_results. All of this comes after calling $gt_form->get_results().
on a field that allows multiple select, it will check for the names of the checkboxes or listbox entries and load all the ones that are found into an array. i.e. if you have a field of checkboxes called "expressions" with the fields "smile" "frown" and "grimace", and select "smile" and "grimace", the recieving page will look for POST['expressions_smile'] = on, POST['expressions_frown'] = on and POST['expressions_grimace'] = on, and find that you have selected smile and frown, and add $this->found_data['expressions'][] = 'smile' and $this->found_data['expressions'][] = 'grimace'. If it finds post input that doesn't fit into the fields defined it will either ignore it, or if it were, for instance, a radio button value that isn't listed, return false.
It can also pull the options multiple selection fields from a seperate file, which currently uses my gt_data flat file data storage/retrieval class, but I think that could be changed pretty easily.
Another feature it has, that might not be so useful, is a function to sort the results into a multidimensional array. By calling for instance:
$settings['named']['uinfo'] = 'uname, password, home';
$settings['misc'] = 'otherinfo';
$sorted_results = gt_form::sort_results($settings);
Would make an array $sorted_results containing two keys 'uinfo' and 'otherinfo', 'uinfo' holding 'uname' 'password' and 'home', and 'otherinfo' holding any other submitted fields.
Right now I'm still fixing it up a little, like making it at least assign a placeholder to empty fields, instead of just not setting them.
I'll put the code of some of my other classes online sometime in the next few days, I have a whole section of my website devoted to them .
here