Chapter 4.14:  Response Information

[TOP] [UP] [PREV] [NEXT]

The "re_" functions provide information about a particular response.  As in the previous section, cnum refers to a conference number, inum to an item number, and rnum to a response number.

$re_exists(cnum inum rnum)

Evaluates to "1" if the response exists, and "0" if the response does not exist or was deleted.

$re_author(cnum inum rnum)

Evaluates to the full name of the author (at the time the response was written).

$re_owner(cnum inum rnum)

Evaluates to the userid of the author (owner) of the response.

$re_time(cnum inum rnum)

Evaluates to the time and date the response was written.

$re_text(cnum inum rnum)

Evaluates to the text of the response.

$re_prop(cnum inum rnum)

Evaluates to the text property number of the response.  (The property numbers are, for the moment, arbitrary, but are being used to distinguish how the user meant a response to be displayed -- e.g., as literal text with explicit line breaks, as plain text to be reformatted as simple HTML, or as explicit HTML as written by the responder.)

$re_title(cnum inum rnum)

Evaluates to the title of the response.  Only response 0 has a title, which is the title of the item.

$re_delete(cnum inum rnum)

Deletes specified response.  If rnum is 0, deletes entire item.  Only the owner of the item or response (or an organizer) can successfully delete an item or response.

$re_epoch(cnum inum rnum)

Evaluates to "epoch" timing (number of seconds since Jan 1 1970) when this response was written.

$re_bits(cnum inum rnum)

Evaluates to any special properties possesed by this particular response.  A bit value of 0x10 means the response was originally written by an organizer.

$re_copier(cnum inum rnum)

Evaluates to the userid of the person who copied this response to its current location.  (If the response was not copied, this evaluates to nothing, i.e. an empty string.)

$re_copied(cnum inum rnum)

Evaluates to the "copied" string stored by add_resp().  It contains the data "conference_name item response date time".  (If the response was not copied, this evaluates to nothing, i.e. an empty string.)

Note: as in chapter 4.13, all of these functions may be written with no arguments.  In that case, the arguments from the previous use of any of these functions (in the same CML page) that did have arguments, are re-used.