CML Reference Guide
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.