Translations

20	#[AllowDynamicProperties]21	class Translations {22		/**23		 * List of translation entries.24		 *25		 * @since 2.8.026		 *27		 * @var Translation_Entry[]28		 */29		public $entries = array();30 31		/**32		 * List of translation headers.33		 *34		 * @since 2.8.035		 *36		 * @var array<string, string>37		 */38		public $headers = array();39 40		/**41		 * Adds an entry to the PO structure.42		 *43		 * @since 2.8.044		 *45		 * @param array|Translation_Entry $entry46		 * @return bool True on success, false if the entry doesn't have a key.47		 */48		public function add_entry( $entry ) {49			if ( is_array( $entry ) ) {50				$entry = new Translation_Entry( $entry );51			}52			$key = $entry->key();53			if ( false === $key ) {54				return false;55			}56			$this->entries[ $key ] = &$entry;57			return true;58		}59 60		/**61		 * Adds or merges an entry to the PO structure.62		 *63		 * @since 2.8.064		 *65		 * @param array|Translation_Entry $entry66		 * @return bool True on success, false if the entry doesn't have a key.67		 */68		public function add_entry_or_merge( $entry ) {69			if ( is_array( $entry ) ) {70				$entry = new Translation_Entry( $entry );71			}72			$key = $entry->key();73			if ( false === $key ) {74				return false;75			}76			if ( isset( $this->entries[ $key ] ) ) {77				$this->entries[ $key ]->merge_with( $entry );78			} else {79				$this->entries[ $key ] = &$entry;80			}81			return true;82		}83 84		/**85		 * Sets $header PO header to $value86		 *87		 * If the header already exists, it will be overwritten88		 *89		 * TODO: this should be out of this class, it is gettext specific90		 *91		 * @since 2.8.092		 *93		 * @param string $header header name, without trailing :94		 * @param string $value header value, without trailing \n95		 */96		public function set_header( $header, $value ) {97			$this->headers[ $header ] = $value;98		}99