otrl_context_find — Look up a connection context
(context, added) otrl_context_find( | ustate, | |
user, | ||
accountname, | ||
protocol, | ||
add_if_missing, | ||
(add_app_data_callback, data)) ; |
OtrlUserState ustate
;String user
;String accountname
;String protocol
;String add_if_missing
;tuple (add_app_data_callback, data)
;Look up a context for the local account (with the given accountname
using the given protocol
) to the remote user
from the given ustate
.
If add_if_missing
is True
, a new context is allocated and returned if one does not currently exist.
In that event,
is called so that the ConnContext's add_app_data_callback
(data=data
, context=the_new_context)app_data
can be filled in by the application.
The tuple containing the add_app_data_callback
function and the the data
is optional, default is not to use app_data
.
Returns a tuple (context, added). context is either the found ConnContext object or None
, added is 1
when the context was newly created (see above) and otherwise 0
.