Node:get-last-text, Next:, Previous:set-user-area, Up:Protocol Requests



get-last-text [58] (3) Recommended


        get-last-text [58] ( before : Time )
                -> ( Text-No );

This call returns the number of the last text created before before. There is no guarantee that the text is readable by the person making the request, or that the text even exists.

This call assumes that all texts are written in chronological order, when the time is expressed in the local time zone of the server. That may not always be the case in real life. When daylight savings time reverts to standard time the same time span will occur twice. The clock of the server may also have been adjusted manually from time to time. This protocol specification does not mandate what the server should do in such cases.

If set-connection-time-format has been used with use-utc set to 1, the before time should be expressed in UTC. Daylight savings time will not be an issue in that case.

Example:

        1 58 49 6 22 19 6 97 6 199 1
        =1 11
        1 58 49 6 22 18 6 97 6 199 1
        =1 8
        1 58 49 6 22 1 6 97 6 199 1
        =1 0

In this example the text created most recently before 22:06 on July 19, 1997 was text number 11; the text created most recently before 22:06 on July 18 was text number 8; and the text created most recently before 22:06 on July 1st was text number 0, which means that there is no text that old in the database.

Error codes


login-first
Login required before issuing this call.