PO

20	class PO extends Gettext_Translations {21 22		public $comments_before_headers = '';23 24		/**25		 * Exports headers to a PO entry26		 *27		 * @return string msgid/msgstr PO entry for this PO file headers, doesn't contain newline at the end28		 */29		public function export_headers() {30			$header_string = '';31			foreach ( $this->headers as $header => $value ) {32				$header_string .= "$header: $value\n";33			}34			$poified = PO::poify( $header_string );35			if ( $this->comments_before_headers ) {36				$before_headers = $this->prepend_each_line( rtrim( $this->comments_before_headers ) . "\n", '# ' );37			} else {38				$before_headers = '';39			}40			return rtrim( "{$before_headers}msgid \"\"\nmsgstr $poified" );41		}42 43		/**44		 * Exports all entries to PO format45		 *46		 * @return string sequence of msgid/msgstr PO strings, doesn't contain a newline at the end47		 */48		public function export_entries() {49			// TODO: Sorting.50			return implode( "\n\n", array_map( array( 'PO', 'export_entry' ), $this->entries ) );51		}52 53		/**54		 * Exports the whole PO file as a string55		 *56		 * @param bool $include_headers whether to include the headers in the export57		 * @return string ready for inclusion in PO file string for headers and all the entries58		 */59		public function export( $include_headers = true ) {60			$res = '';61			if ( $include_headers ) {62				$res .= $this->export_headers();63				$res .= "\n\n";64			}65			$res .= $this->export_entries();66			return $res;67		}68 69		/**70		 * Same as {@link export}, but writes the result to a file71		 *72		 * @param string $filename        Where to write the PO string.73		 * @param bool   $include_headers Whether to include the headers in the export.74		 * @return bool true on success, false on error75		 */76		public function export_to_file( $filename, $include_headers = true ) {77			$fh = fopen( $filename, 'w' );78			if ( false === $fh ) {79				return false;80			}81			$export = $this->export( $include_headers );82			$res    = fwrite( $fh, $export );83			if ( false === $res ) {84				return false;85			}86			return fclose( $fh );87		}88 89		/**90		 * Text to include as a comment before the start of the PO contents91		 *92		 * Doesn't need to include # in the beginning of lines, these are added automatically93		 *94		 * @param string $text Text to include as a comment.95		 */96		public function set_comment_before_headers( $text ) {97			$this->comments_before_headers = $text;98		}99