hyper_sync/header/common/
accept_language.rs

1use language_tags::LanguageTag;
2
3use header::QualityItem;
4
5header! {
6    /// `Accept-Language` header, defined in
7    /// [RFC7231](http://tools.ietf.org/html/rfc7231#section-5.3.5)
8    ///
9    /// The `Accept-Language` header field can be used by user agents to
10    /// indicate the set of natural languages that are preferred in the
11    /// response.
12    ///
13    /// # ABNF
14    ///
15    /// ```text
16    /// Accept-Language = 1#( language-range [ weight ] )
17    /// language-range  = <language-range, see [RFC4647], Section 2.1>
18    /// ```
19    ///
20    /// # Example values
21    /// * `da, en-gb;q=0.8, en;q=0.7`
22    /// * `en-us;q=1.0, en;q=0.5, fr`
23    ///
24    /// # Examples
25    ///
26    /// ```
27    /// use hyper_sync::header::{Headers, AcceptLanguage, LanguageTag, qitem};
28    ///
29    /// let mut headers = Headers::new();
30    /// let mut langtag: LanguageTag = Default::default();
31    /// langtag.language = Some("en".to_owned());
32    /// langtag.region = Some("US".to_owned());
33    /// headers.set(
34    ///     AcceptLanguage(vec![
35    ///         qitem(langtag),
36    ///     ])
37    /// );
38    /// ```
39    ///
40    /// ```
41    /// # extern crate hyper_sync;
42    /// # #[macro_use] extern crate language_tags;
43    /// # use hyper_sync::header::{Headers, AcceptLanguage, QualityItem, q, qitem};
44    /// #
45    /// # fn main() {
46    /// let mut headers = Headers::new();
47    /// headers.set(
48    ///     AcceptLanguage(vec![
49    ///         qitem(langtag!(da)),
50    ///         QualityItem::new(langtag!(en;;;GB), q(800)),
51    ///         QualityItem::new(langtag!(en), q(700)),
52    ///     ])
53    /// );
54    /// # }
55    /// ```
56    (AcceptLanguage, "Accept-Language") => (QualityItem<LanguageTag>)+
57
58    test_accept_language {
59        // From the RFC
60        test_header!(test1, vec![b"da, en-gb;q=0.8, en;q=0.7"]);
61        // Own test
62        test_header!(
63            test2, vec![b"en-US, en; q=0.5, fr"],
64            Some(AcceptLanguage(vec![
65                qitem("en-US".parse().unwrap()),
66                QualityItem::new("en".parse().unwrap(), q(500)),
67                qitem("fr".parse().unwrap()),
68        ])));
69    }
70}
71
72bench_header!(bench, AcceptLanguage,
73              { vec![b"en-us;q=1.0, en;q=0.5, fr".to_vec()] });
hyper_sync/header/common/accept_language.rs

hyper_sync/header/common/
accept_language.rs
