cogo_http/header/common/
accept_language.rs

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

cogo_http/header/common/
accept_language.rs
