Node:get-created-texts, Next:get-members-old, Previous:get-membership-old, Up:Protocol Requests

get-created-texts [47] (1) Obsolete (10)

        get-created-texts [47] (( person        :   Pers-No;
                                  first         :   Local-Text-No;
                                  no-of-texts   :   INT32 ))
                -> ( Text-List );

This call is obsolete; instead you should use map-created-texts.

This call returns a list of the texts written by a person. person is the person whose created texts are to be retrieved. first is the first text to retrieve. no-of-texts is the number of texts to retrieve.

This call is essentially the same as get-map, but instead of returning the texts sent to a single conference, it returns the texts written by a single person to any conference. The number of texts written by any one person is contained in the Person record for that person.

If first is lower than the first text written by person that still exists, it will be automatically increased to the first still existing text written by person. The get-created-texts will still attempt to return information about no-of-texts texts. (In this regard get-map and get-created-texts differ, since get-map will never ever return information about a later text than specified in the arguments to the call.¹)

Example:

        1 47 5 0 100
        =1 1 8 { 1 2 3 4 5 6 7 8 }
        2 47 5 4 2
        =2 4 2 { 4 5 }
        3 47 10 8 8
        =3 12 8 { 309 312 324 327 329 339 0 387 }

In this example we have retrieved all texts written by person five. The first call asked for 100 texts, but only 8 were returned, which implies that person number 5 only created a total of 8 texts. We can also see that person 5 wrote all the first 8 texts in the conference system. The second call shows how a part of the map can be retrieved.

The third call asks for eight texts written by person 10, starting with the eighth number. Since the first eleven texts written by that person no longer exists the server instead returns information about eight texts staring from the twelfth text person 10 created. One of the eight texts has been deleted.

Error codes

login-first

Login required before issuing this call.

undefined-person

The person person does not exist or is secret.

undefined-conference

The conference person does not exist or is secret.

no-such-local-text

first is higher than the local text number of the last created text.

Footnotes

1. This difference was not intentional, but it is now too late to change the semantics of either get-map or get-created-texts. Besides, they are both obsolete calls.