PO

30	class PO extends Gettext_Translations {31 32		public $comments_before_headers = '';33 34		/**35		 * Exports headers to a PO entry36		 *37		 * @return string msgid/msgstr PO entry for this PO file headers, doesn't contain newline at the end38		 */39		public function export_headers() {40			$header_string = '';41			foreach ( $this->headers as $header => $value ) {42				$header_string .= "$header: $value\n";43			}44			$poified = PO::poify( $header_string );45			if ( $this->comments_before_headers ) {46				$before_headers = $this->prepend_each_line( rtrim( $this->comments_before_headers ) . "\n", '# ' );47			} else {48				$before_headers = '';49			}50			return rtrim( "{$before_headers}msgid \"\"\nmsgstr $poified" );51		}52 53		/**54		 * Exports all entries to PO format55		 *56		 * @return string sequence of msgid/msgstr PO strings, doesn't contain a newline at the end57		 */58		public function export_entries() {59			// TODO: Sorting.60			return implode( "\n\n", array_map( array( 'PO', 'export_entry' ), $this->entries ) );61		}62 63		/**64		 * Exports the whole PO file as a string65		 *66		 * @param bool $include_headers whether to include the headers in the export67		 * @return string ready for inclusion in PO file string for headers and all the entries68		 */69		public function export( $include_headers = true ) {70			$res = '';71			if ( $include_headers ) {72				$res .= $this->export_headers();73				$res .= "\n\n";74			}75			$res .= $this->export_entries();76			return $res;77		}78 79		/**80		 * Same as {@link export}, but writes the result to a file81		 *82		 * @param string $filename        Where to write the PO string.83		 * @param bool   $include_headers Whether to include the headers in the export.84		 * @return bool true on success, false on error85		 */86		public function export_to_file( $filename, $include_headers = true ) {87			$fh = fopen( $filename, 'w' );88			if ( false === $fh ) {89				return false;90			}91			$export = $this->export( $include_headers );92			$res    = fwrite( $fh, $export );93			if ( false === $res ) {94				return false;95			}96			return fclose( $fh );97		}98 99		/**100		 * Text to include as a comment before the start of the PO contents101		 *102		 * Doesn't need to include # in the beginning of lines, these are added automatically103		 *104		 * @param string $text Text to include as a comment.105		 */106		public function set_comment_before_headers( $text ) {107			$this->comments_before_headers = $text;108		}109