Skip to main content

localized_query_state

Function localized_query_state 

Source
pub fn localized_query_state(
    state: &State,
    language: Option<&[LanguageRange]>,
) -> State
Expand description

The queryState to return from a Foo/query whose language was language (draft-atwood-jmap-updates-00 §4.2.3: “The queryState of a /query result reflects the language it was computed with”).

With language None the backend’s state is returned unchanged. Otherwise it is wrapped as <state>|lang=<r1>,<r2>, the ranges in canonical case (decision 28). Backend query states MUST NOT contain |lang=. unwrap_query_state reverses it.

use jmap_server::{localized_query_state, unwrap_query_state};
use jmap_types::State;
use jmap_types::i18n::LanguageRange;

let de: Vec<LanguageRange> = vec!["DE-ch".parse().unwrap(), "de".parse().unwrap()];
let wrapped = localized_query_state(&State::from("17"), Some(&de));
assert_eq!(wrapped.as_ref(), "17|lang=de-CH,de");
assert_eq!(unwrap_query_state(&wrapped, Some(&de)).unwrap().as_ref(), "17");
assert!(unwrap_query_state(&wrapped, None).is_err());