set_sexp_sync


Description:

public bool set_sexp_sync (string sexp, Cancellable? cancellable = null) throws Error

Sets the Search Expression for the cursor.

A side effect of setting the search expression is that the position and total properties will be updated.

If this method is called from the same thread context in which the cursor was created, then the updates to the position and total properties are guaranteed to be delivered synchronously upon successful completion of setting the search expression. Otherwise, notifications will be delivered asynchronously in the cursor's original thread context.

If the backend does not support the given search expression, an INVALID_QUERY error will be set.

Parameters:

this

an BookClientCursor

sexp

the new search expression for this

cancellable

a Cancellable to optionally cancel this operation while in progress

Returns:

true on success, otherwise false is returned and error is set.