mdref.json config
[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:***
6 > The message chains must not overlap.
7
8 ## Params:
9
10 * http\Message $message
11 The message (chain) to prepend as parent messages.
12 * Optional bool $top = true
13 Whether to prepend to the top-most parent message.
14
15 ## Returns:
16
17 * http\Message, self.
18
19 ## Throws:
20
21 * http\Exception\InvalidArgumentException
22 * http\Exception\UnexpectedValueException