summaryrefslogtreecommitdiffstats
path: root/vendor/ipl/stdlib/src/Messages.php
blob: b601c1d597ede529ea352ac1b0918813a0a0d5e9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<?php

namespace ipl\Stdlib;

trait Messages
{
    /** @var array */
    protected $messages = [];

    /**
     * Get whether there are any messages
     *
     * @return bool
     */
    public function hasMessages()
    {
        return ! empty($this->messages);
    }

    /**
     * Get all messages
     *
     * @return array
     */
    public function getMessages()
    {
        return $this->messages;
    }

    /**
     * Set the given messages overriding existing ones
     *
     * @param string[] $messages
     *
     * @return $this
     */
    public function setMessages(array $messages)
    {
        $this->clearMessages();

        foreach ($messages as $message) {
            $this->addMessage($message);
        }

        return $this;
    }

    /**
     * Add a single message
     *
     * @param string $message
     * @param mixed  ...$args Optional args for sprintf-style messages
     *
     * @return $this
     */
    public function addMessage($message, ...$args)
    {
        if (empty($args)) {
            $this->messages[] = $message;
        } else {
            $this->messages[] = vsprintf($message, $args);
        }

        return $this;
    }

    /**
     * Add the given messages
     *
     * @param array $messages
     *
     * @return $this
     */
    public function addMessages(array $messages)
    {
        $this->messages = array_merge($this->messages, $messages);

        return $this;
    }

    /**
     * Drop any existing message
     *
     * @return $this
     */
    public function clearMessages()
    {
        $this->messages = [];

        return $this;
    }
}