api: allow to filter by unread in chatlist:try_load (#4824)

close #4738
This commit is contained in:
Sebastian Klähn
2023-10-14 11:12:53 +02:00
committed by GitHub
parent da5d844ec4
commit b239535964
2 changed files with 43 additions and 7 deletions

View File

@@ -884,7 +884,8 @@ int dc_preconfigure_keypair (dc_context_t* context, const cha
* - if the flag DC_GCL_ADD_ALLDONE_HINT is set, DC_CHAT_ID_ALLDONE_HINT
* is added as needed.
* @param query_str An optional query for filtering the list. Only chats matching this query
* are returned. Give NULL for no filtering.
* are returned. Give NULL for no filtering. When `is:unread` is contained in the query,
* the chatlist is filtered such that only chats with unread messages show up.
* @param query_id An optional contact ID for filtering the list. Only chats including this contact ID
* are returned. Give 0 for no filtering.
* @return A chatlist as an dc_chatlist_t object.