Struct http_str::Request

pub struct Request<'a> {
    pub entire_req: &'a str,
    pub method: &'a str,
    pub uri: &'a str,
    pub query: &'a str,
    pub version: &'a str,
    pub body: &'a str,
    pub headers_map: BTreeMap<&'a str, Vec<&'a str>>,
    // some fields omitted
}

Fields

entire_req: &'a str

method: &'a str

uri: &'a str

query: &'a str

version: &'a str

body: &'a str

headers_map: BTreeMap<&'a str, Vec<&'a str>>

Methods

impl<'a> Request<'a>

pub fn new(bytes: &'a [u8]) -> Pin<Box<Self>>

Creates a new Request from a slice of bytes utf8 encoded forming a http request.

It is up to the caller that these bytes are valid utf8.

Panics

This function will panic if the bytes contain no space character(32).

Examples

use std::str::from_utf8_unchecked;
use http_str::Request;

let req = b"GET /index.html?myquery HTTP/1.1\r\nHost: www.example.com\r\nHello world!";
let request = Request::new(req);

assert_eq!(request.entire_req, unsafe { from_utf8_unchecked(req) });
assert_eq!(request.method, "GET"); // all the other fields refer to `entire_req`
assert_eq!(request.uri, "/index.html");
assert_eq!(request.query, "myquery");
assert_eq!(request.version, "HTTP/1.1");
assert_eq!(request.headers_map["Host"], vec!["www.example.com"]);
assert_eq!(request.body, "Hello world!");

pub fn with_method_len(bytes: &'a [u8], method_len: usize) -> Pin<Box<Self>>

Creates a new Request from a slice of bytes utf8 encoded forming a http request and the length of the http method.

This will not produce the correct result if method_len is incorrect but takes less time than the normal constructor, use it when you do know the method of the request.

Trait Implementations

impl<'a> Display for Request<'a>

fn fmt(&self, fmt: &mut Formatter) -> FmtResult

Formats the value using the given formatter.