1 | <?php |
||
24 | class AliasGroupList implements Countable, IteratorAggregate { |
||
25 | |||
26 | /** |
||
27 | * @var AliasGroup[] |
||
28 | */ |
||
29 | private $groups = []; |
||
30 | |||
31 | /** |
||
32 | * @param AliasGroup[] $aliasGroups |
||
33 | * @throws InvalidArgumentException |
||
34 | */ |
||
35 | 44 | public function __construct( array $aliasGroups = [] ) { |
|
44 | |||
45 | /** |
||
46 | * @see Countable::count |
||
47 | * @return int |
||
48 | */ |
||
49 | 6 | public function count() { |
|
52 | |||
53 | /** |
||
54 | * @see IteratorAggregate::getIterator |
||
55 | * @return Traversable|AliasGroup[] |
||
56 | */ |
||
57 | 3 | public function getIterator() { |
|
60 | |||
61 | /** |
||
62 | * The array keys are the language codes of their associated AliasGroup. |
||
63 | * |
||
64 | * @since 2.3 |
||
65 | * |
||
66 | * @return AliasGroup[] Array indexed by language code. |
||
67 | */ |
||
68 | 1 | public function toArray() { |
|
71 | |||
72 | /** |
||
73 | * @param string $languageCode |
||
74 | * |
||
75 | * @return AliasGroup |
||
76 | * @throws OutOfBoundsException |
||
77 | */ |
||
78 | public function getByLanguage( $languageCode ) { |
||
79 | 6 | if ( !array_key_exists( $languageCode, $this->groups ) ) { |
|
80 | 6 | throw new OutOfBoundsException( 'AliasGroup with languageCode "' . $languageCode . '" not found' ); |
|
81 | } |
||
82 | 3 | ||
83 | 1 | return $this->groups[$languageCode]; |
|
84 | } |
||
85 | |||
86 | 2 | /** |
|
87 | * @since 2.5 |
||
88 | * |
||
89 | * @param string[] $languageCodes |
||
90 | * |
||
91 | * @return self |
||
92 | */ |
||
93 | public function getWithLanguages( array $languageCodes ) { |
||
96 | 4 | ||
97 | 4 | /** |
|
98 | * @param string $languageCode |
||
99 | */ |
||
100 | public function removeByLanguage( $languageCode ) { |
||
101 | unset( $this->groups[$languageCode] ); |
||
102 | } |
||
103 | |||
104 | 5 | /** |
|
105 | 5 | * If the group is empty, it will not be stored. |
|
106 | 2 | * In case the language of that group had an associated group, that group will be removed. |
|
107 | 2 | * |
|
108 | * @param AliasGroup $group |
||
109 | 17 | */ |
|
110 | 17 | public function setGroup( AliasGroup $group ) { |
|
111 | 9 | if ( $group->isEmpty() ) { |
|
112 | unset( $this->groups[$group->getLanguageCode()] ); |
||
113 | 8 | } |
|
114 | else { |
||
115 | $this->groups[$group->getLanguageCode()] = $group; |
||
116 | } |
||
117 | } |
||
118 | |||
119 | /** |
||
120 | * @see Comparable::equals |
||
121 | 25 | * |
|
122 | 25 | * @since 0.7.4 |
|
123 | 3 | * |
|
124 | 3 | * @param mixed $target |
|
125 | * |
||
126 | 25 | * @return bool |
|
127 | */ |
||
128 | 25 | public function equals( $target ) { |
|
147 | 2 | ||
148 | /** |
||
149 | * @since 2.4.0 |
||
150 | 3 | * |
|
151 | 2 | * @return bool |
|
152 | */ |
||
153 | public function isEmpty() { |
||
156 | 3 | ||
157 | /** |
||
158 | * @since 0.7.4 |
||
159 | * |
||
160 | * @param AliasGroup $group |
||
161 | * |
||
162 | * @return boolean |
||
163 | */ |
||
164 | 1 | public function hasAliasGroup( AliasGroup $group ) { |
|
168 | |||
169 | /** |
||
170 | * @since 0.8 |
||
171 | * |
||
172 | * @param string $languageCode |
||
173 | * |
||
174 | * @return boolean |
||
175 | 5 | */ |
|
176 | 5 | public function hasGroupForLanguage( $languageCode ) { |
|
179 | |||
180 | /** |
||
181 | * @since 0.8 |
||
182 | * |
||
183 | * @param string $languageCode |
||
184 | * @param string[] $aliases |
||
185 | */ |
||
186 | public function setAliasesForLanguage( $languageCode, array $aliases ) { |
||
187 | 6 | $this->setGroup( new AliasGroup( $languageCode, $aliases ) ); |
|
188 | 6 | } |
|
189 | 3 | ||
190 | /** |
||
191 | * Returns an array with language codes as keys the aliases as array values. |
||
192 | * |
||
193 | * @since 2.5 |
||
194 | * |
||
195 | * @return array[] |
||
196 | */ |
||
197 | public function toTextArray() { |
||
206 | |||
207 | /** |
||
208 | * Removes all alias groups from this list. |
||
209 | 1 | * |
|
210 | 1 | * @since 6.0 |
|
211 | */ |
||
212 | 1 | public function clear() { |
|
215 | |||
216 | } |
||
217 |