Query

---

Object Hierarchy:

Description:

Content:

Properties:

• public string author { set; get; }
  An entry author. The service returns entries where the author name and/or e-mail address match your query string.
• public string categories { set; get; }
• public string etag { set; get; }
  The ETag against which to check for updates. If the server-side ETag matches this one, the requested feed hasn't changed, and is not returned unnecessarily.
• public bool is_strict { set; get; }
  Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is not recognised.
• public uint max_results { set; get; }
  Maximum number of results to be retrieved. Most services have a default max_results size imposed by the server; if you wish to receive the entire feed, specify a large number such as MAX for this property.
• public int64 published_max { set; get; }
  Upper bound on the entry publish date, exclusive.
• public int64 published_min { set; get; }
  Lower bound on the entry publish date, inclusive.
• public string q { set; get; }
• public uint start_index { set; get; }
  The one-based index of the first result to be retrieved. Use next_page and previous_page to implement pagination, rather than manually changing start_index.
• public int64 updated_max { set; get; }
  Upper bound on the entry update date, exclusive.
• public int64 updated_min { set; get; }
  Lower bound on the entry update date, inclusive.

Creation methods:

• public Query (string? q)
  Creates a new Query with its q property set to q.
• public Query.with_limits (string? q, uint start_index, uint max_results)
  Creates a new Query with its q property set to q, and the limits start_index and max_results applied.

Methods:

• public unowned string get_author ()
  Gets the author property.
• public unowned string get_categories ()
  Gets the categories property.
• public unowned string get_etag ()
  Gets the etag property.
• public uint get_max_results ()
  Gets the max_results property.
• public int64 get_published_max ()
  Gets the published_max property. If the property is unset, -1 will be returned.
• public int64 get_published_min ()
  Gets the published_min property. If the property is unset, -1 will be returned.
• public unowned string get_q ()
  Gets the q property.
• public virtual void get_query_uri (string feed_uri, StringBuilder query_uri, bool params_started)
  Builds a query URI from the given base feed URI, using the properties of the Query. This function will take care of all necessary URI escaping, so it should not be done beforehand.
• public uint get_start_index ()
  Gets the start_index property.
• public int64 get_updated_max ()
  Gets the updated_max property. If the property is unset, -1 will be returned.
• public int64 get_updated_min ()
  Gets the updated_min property. If the property is unset, -1 will be returned.
• public void next_page ()
  Changes the state of the Query such that when get_query_uri is next called, it will build the query URI for the next page in the result set.
• public bool previous_page ()
  Changes the state of the Query such that when get_query_uri is next called, it will build the query URI for the previous page in the result set.
• public void set_author (string? author)
  Sets the author property of the Query to the new author string, author.
• public void set_categories (string? categories)
  Sets the categories property of the Query to the new category string, categories.
• public void set_etag (string? etag)
  Sets the etag property of the Query to the new ETag, etag.
• public void set_is_strict (bool is_strict)
  Sets the is_strict property of the Query to the new strict value, is_strict.
• public void set_max_results (uint max_results)
  Sets the max_results property of the Query to the new maximum results value, max_results.
• public void set_published_max (int64 published_max)
  Sets the published_max property of the Query to the new maximum publish time, published_max.
• public void set_published_min (int64 published_min)
  Sets the published_min property of the Query to the new minimum publish time, published_min.
• public void set_q (string? q)
  Sets the q property of the Query to the new query string, q.
• public void set_start_index (uint start_index)
  Sets the start_index property of the Query to the new one-based start index, start_index.
• public void set_updated_max (int64 updated_max)
  Sets the updated_max property of the Query to the new maximum update time, updated_max.
• public void set_updated_min (int64 updated_min)
  Sets the updated_min property of the Query to the new minimum update time, updated_min.