Node:re-z-lookup, Next:get-version-info, Previous:unmark-text, Up:Protocol Requests
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]".
regexp-error
regexp. Perhaps the pattern is
not a correct regexp.
bad-bool
want-persons and want-confs must be either 0 or
1.