Skip to main content

parse_payload

Function parse_payload 

Source
pub fn parse_payload(payload: &[u8]) -> Result<Response<'_>, PayloadError>
Expand description

Parses a complete connectionless response packet into its response type.

For fragmented or compressed responses, first pass datagrams through PacketProcessor::process. The returned response may borrow string data directly from payload.

ยงErrors

Returns PayloadError if the packet header is unknown, a required field is missing, a string is not valid UTF-8, or a response-specific value is invalid.

Examples found in repository?
examples/query.rs (line 55)
23fn main() -> Result<(), Box<dyn Error>> {
24    let mut args = std::env::args().skip(1);
25
26    let addr = args.next().unwrap_or_else(|| usage());
27    let kind = args.next().unwrap_or_else(|| "info".into());
28
29    let request = match kind.as_str() {
30        "info" => Request::Info,
31        "players" => Request::Players,
32        "rules" => Request::Rules,
33        _ => usage(),
34    };
35
36    // just some socket setup
37    let socket = UdpSocket::bind("0.0.0.0:0")?;
38    socket.set_read_timeout(Some(Duration::from_secs(2)))?;
39
40    // initial request
41    let mut proc = PacketProcessor::new();
42    socket.send_to(&send_buf(request, None), addr)?;
43
44    loop {
45        let mut buf = [0u8; MAX_PACKET_SIZE];
46        let (len, addr) = socket.recv_from(&mut buf)?;
47        let buf = &buf[..len];
48
49        // does all the work with packet assembling if requires
50        // if it's still not ready, we loop again
51        let Some(resp) = proc.process(addr, buf)? else {
52            continue;
53        };
54
55        match parse_payload(&resp)? {
56            // send challenge if demands
57            Response::Challenge(num) => {
58                socket.send_to(&send_buf(request, Some(num)), addr)?;
59                continue;
60            }
61            // we got any, so print and exit
62            other => {
63                println!("{:#?}", other);
64                break;
65            }
66        }
67    }
68
69    Ok(())
70}