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}