big update's coming
[mdref/mdref-http] / http / Message / reverse.md
1 # http\Message http\Messae::reverse()
2
3 Reverse the message chain and return the former top-most message.
4
5 > **Note:** Message chains are ordered in reverse-parsed order by default, i.e. the last parsed message is the message you'll receive from any call parsing HTTP messages.
6 >
7 > This call re-orders the messages of the chain and returns the message that was parsed first with any later parsed messages re-parentized.
8
9 ## Params:
10
11 None.
12
13 ## Returns:
14
15 * http\Message, the other end of the message chain.
16
17 ## Throws:
18
19 * http\Exception\InvalidArgumentException