Node:re-z-lookup, Next:, Previous:unmark-text, Up:Protocol Requests



re-z-lookup [74] (7) Recommended


        re-z-lookup [74] (( regexp          :   HOLLERITH;
                            want-persons    :   BOOL;
                            want-confs      :   BOOL ))
                -> ( ARRAY Conf-Z-Info );

This call returns a list of those conferences and/or persons matching the regular expression regexp. If want-confs is true, then the result will include non-mailbox conferences. If want-persons is true, then the result will include mailbox conferences.

See also lookup-z-name, for an alternative way to look up names.

Refer to Name Expansion, for more details on how name lookup works.

Example:

    1 74 2H.* 1 1
    =1 4 { 15HTest Conference 0000 10 11HDavid Byers 1001 6
            21HTrains (-) Discussion 0000 11 4HJohn 1001 9 }
    2 74 2H.* 0 1
    =2 2 { 15HTest Conference 0000 10
           21HTrains (-) Discussion 0000 11 }
    3 74 7HT.*[cC] 1 1
    =3 2 { 15HTest Conference 0000 10
           21HTrains (-) Discussion 0000 11 }

This example shows three calls to re-z-lookup. The first call returns all conferences and persons in the entire database, in this case two conferences and two persons. The second example uses the same regular expression, but in this case, the call specifies that the result is only to contain conferences, so the two persons are not returned. The third example simply returns all names matching the pattern "T.*[cC]".

Error codes

regexp-error
Error compiling the regexp regexp. Perhaps the pattern is not a correct regexp.