Returns a count of records matching this query's conditions.
Returns a count of records matching this query's conditions. May not be supported by all repositories; in particular, it is not supported by ContentProviders.
Returns a new query whose results will be limited to the given number of rows.
Returns a new query whose results will be limited to the given number of rows. May not be supported by all repositories; in particular, it is not supported by ContentProviders.
Returns a new ContentQuery
, equivalent to this one, except
that results will be ordered as per the given String
.
Returns a new ContentQuery
, equivalent to this one, except
that results will be ordered as per the given String
.
Interpretation of the String
s is as per the underlying APIs,
e.g., as for a SQL order by
when querying a database.
Returns a new ContentQuery with the same semantics as this one, except that it adds extra conditions.
Returns a new ContentQuery with the same semantics as this one, except that it adds extra conditions. If the condition contains '?' placeholders, they will be replaced with ContentValue arguments, e.g.
qry = otherQuery.where( "created_at > ? and status = ?", myDate.getTime, "in_progress" )
Returns a new ContentQuery with the same semantics as this one,
except that it adds the condition that each of the fields named
by the String
s in the arguments should be equal to the associated
ContentValue.
Returns a new ContentQuery with the same semantics as this one,
except that it adds the condition that each of the fields named
by the String
s in the arguments should be equal to the associated
ContentValue. E.g.,
qry = otherQuery.where( "status" -> "in_progress", "urgency_level" -> 3 )
using the same shorthand for pairs as is commonly used for
Map
constructors.
All conditions on this ContentQuery.
All conditions on this ContentQuery. Useful to determine when two are equivalent.
Delete all records which match this ContentQuery
Inserts a new record, with values of the columns
named by the String
s to each associated
ContentValue.
Inserts a new record, with values of the columns
named by the String
s to each associated
ContentValue. E.g.,
qry.insert( "description" -> "write documentation", "status" -> "in_progress", "urgency_level" -> 3 )
using the same shorthand for pairs as is commonly used for
Map
constructors.
Returns a new query whose results will be limited to the given number of rows.
Returns a new query whose results will be limited to the given number of rows. May not be supported by all repositories; in particular, it is not supported by ContentProviders.
Return a PositronicCursor for the
values of the given columns, in records
matching this query, respecting its order
and limit
.
Return a PositronicCursor for the
values of the given columns, in records
matching this query, respecting its order
and limit
.
(This is a wrapper around standard Android Cursor
s, which provides
a few extra features; its wrappedCursorAs
method can be used to
get the underlying raw Cursor, if you want it.)
Return a PositronicCursor for the
values of the underlying resource's default set of columns, in records
matching this query, respecting its order
and limit
.
Return a PositronicCursor for the
values of the underlying resource's default set of columns, in records
matching this query, respecting its order
and limit
.
(This is a wrapper around standard Android Cursor
s, which provides
a few extra features; its wrappedCursorAs
method can be used to
get the underlying raw Cursor, if you want it.)
Updates each record matched by the query, setting values of the columns
named by the String
s to each associated
ContentValue.
Updates each record matched by the query, setting values of the columns
named by the String
s to each associated
ContentValue. E.g.,
qry.update( "status" -> "in_progress", "urgency_level" -> 3 )
using the same shorthand for pairs as is commonly used for
Map
constructors.
Query on an arbitrary content source. See the content package overview for expected usage.
Note that as an implementation cheat, this internally represents query parameters (e.g., limitString) which not all ContentSources will support. We expect to stay safe because the publicly exported subclasses that you get from the content sources won't let users set the fields that the source can't support.