big update's coming
[mdref/mdref-http] / http / Message / prepend.md
1 # http\Message http\Message::prepend(http\Message $message[, bool $top = true])
2
3 Prepend message(s) $message to this message, or the top most message of this message chain.
4
5 > **Note:** The message chains must not overlap.
6
7 ## Params:
8
9 * http\Message $message
10 The message (chain) to prepend as parent messages.
11 * Optional bool $top = true
12 Whether to prepend to the top-most parent message.
13
14 ## Returns:
15
16 * http\Message, self.
17
18 ## Throws:
19
20 * http\Exception\InvalidArgumentException
21 * http\Exception\UnexpectedValueException