enmi-conf.org: comparison wp/wp-includes/pomo/mo.php

equal deleted inserted replaced

-:3d4e9c994f10
+:a86126ab1dd4
 * @version $Id: mo.php 1157 2015-11-20 04:30:11Z dd32 $
 * @package pomo
 * @subpackage mo
 */
-require_once dirname( __FILE__ ) . '/translations.php';
+require_once __DIR__ . '/translations.php';
-require_once dirname( __FILE__ ) . '/streams.php';
+require_once __DIR__ . '/streams.php';
 if ( ! class_exists( 'MO', false ) ) :
 	class MO extends Gettext_Translations {
 		var $_nplurals = 2;
 		function export_to_file_handle( $fh ) {
 			$entries = array_filter( $this->entries, array( $this, 'is_entry_good_for_export' ) );
 			ksort( $entries );
 			$magic                     = 0x950412de;
 			$revision                  = 0;
-			$total                     = count( $entries ) + 1; // all the headers are one entry
+			$total                     = count( $entries ) + 1; // All the headers are one entry.
 			$originals_lenghts_addr    = 28;
 			$translations_lenghts_addr = $originals_lenghts_addr + 8 * $total;
 			$size_of_hash              = 0;
 			$hash_addr                 = $translations_lenghts_addr + 8 * $total;
 			$current_addr              = $hash_addr;
 					$hash_addr
 				)
 			);
 			fseek( $fh, $originals_lenghts_addr );
-			// headers' msgid is an empty string
+			// Headers' msgid is an empty string.
 			fwrite( $fh, pack( 'VV', 0, $current_addr ) );
 			$current_addr++;
 			$originals_table = "\0";
 			$reader = new POMO_Reader();
 			foreach ( $entries as $entry ) {
 				$originals_table .= $this->export_original( $entry ) . "\0";
 				$length           = $reader->strlen( $this->export_original( $entry ) );
 				fwrite( $fh, pack( 'VV', $length, $current_addr ) );
-				$current_addr += $length + 1; // account for the NULL byte after
+				$current_addr += $length + 1; // Account for the NULL byte after.
 			}
 			$exported_headers = $this->export_headers();
 			fwrite( $fh, pack( 'VV', $reader->strlen( $exported_headers ), $current_addr ) );
 			$current_addr      += strlen( $exported_headers ) + 1;
 		/**
 		 * @param Translation_Entry $entry
 		 * @return string
 		 */
 		function export_original( $entry ) {
-			//TODO: warnings for control characters
+			// TODO: Warnings for control characters.
 			$exported = $entry->singular;
 			if ( $entry->is_plural ) {
 				$exported .= "\0" . $entry->plural;
 			}
 			if ( $entry->context ) {
 		/**
 		 * @param Translation_Entry $entry
 		 * @return string
 		 */
 		function export_translations( $entry ) {
-			//TODO: warnings for control characters
+			// TODO: Warnings for control characters.
 			return $entry->is_plural ? implode( "\0", $entry->translations ) : $entry->translations[0];
 		}
 		/**
 		 * @return string
 		/**
 		 * @param int $magic
 		 * @return string|false
 		 */
 		function get_byteorder( $magic ) {
-			// The magic is 0x950412de
+			// The magic is 0x950412de.
 			// bug in PHP 5.0.2, see https://savannah.nongnu.org/bugs/?func=detailitem&item_id=10565
 			$magic_little    = (int) - 1794895138;
 			$magic_little_64 = (int) 2500072158;
 			// 0xde120495
 			if ( false === $endian_string ) {
 				return false;
 			}
 			$reader->setEndian( $endian_string );
-			$endian = ( 'big' == $endian_string ) ? 'N' : 'V';
+			$endian = ( 'big' === $endian_string ) ? 'N' : 'V';
 			$header = $reader->read( 24 );
 			if ( $reader->strlen( $header ) != 24 ) {
 				return false;
 			}
-			// parse header
+			// Parse header.
 			$header = unpack( "{$endian}revision/{$endian}total/{$endian}originals_lenghts_addr/{$endian}translations_lenghts_addr/{$endian}hash_length/{$endian}hash_addr", $header );
 			if ( ! is_array( $header ) ) {
 				return false;
 			}
-			// support revision 0 of MO format specs, only
+			// Support revision 0 of MO format specs, only.
-			if ( $header['revision'] != 0 ) {
+			if ( 0 != $header['revision'] ) {
 				return false;
 			}
-			// seek to data blocks
+			// Seek to data blocks.
 			$reader->seekto( $header['originals_lenghts_addr'] );
-			// read originals' indices
+			// Read originals' indices.
 			$originals_lengths_length = $header['translations_lenghts_addr'] - $header['originals_lenghts_addr'];
 			if ( $originals_lengths_length != $header['total'] * 8 ) {
 				return false;
 			}
 			$originals = $reader->read( $originals_lengths_length );
 			if ( $reader->strlen( $originals ) != $originals_lengths_length ) {
 				return false;
 			}
-			// read translations' indices
+			// Read translations' indices.
 			$translations_lenghts_length = $header['hash_addr'] - $header['translations_lenghts_addr'];
 			if ( $translations_lenghts_length != $header['total'] * 8 ) {
 				return false;
 			}
 			$translations = $reader->read( $translations_lenghts_length );
 			if ( $reader->strlen( $translations ) != $translations_lenghts_length ) {
 				return false;
 			}
-			// transform raw data into set of indices
+			// Transform raw data into set of indices.
 			$originals    = $reader->str_split( $originals, 8 );
 			$translations = $reader->str_split( $translations, 8 );
-			// skip hash table
+			// Skip hash table.
 			$strings_addr = $header['hash_addr'] + $header['hash_length'] * 4;
 			$reader->seekto( $strings_addr );
 			$strings = $reader->read_all();
 				$t = unpack( "{$endian}length/{$endian}pos", $translations[ $i ] );
 				if ( ! $o || ! $t ) {
 					return false;
 				}
-				// adjust offset due to reading strings to separate space before
+				// Adjust offset due to reading strings to separate space before.
 				$o['pos'] -= $strings_addr;
 				$t['pos'] -= $strings_addr;
 				$original    = $reader->substr( $strings, $o['pos'], $o['length'] );
 				$translation = $reader->substr( $strings, $t['pos'], $t['length'] );
 			$parts = explode( "\4", $original );
 			if ( isset( $parts[1] ) ) {
 				$original       = $parts[1];
 				$entry->context = $parts[0];
 			}
-			// look for plural original
+			// Look for plural original.
 			$parts           = explode( "\0", $original );
 			$entry->singular = $parts[0];
 			if ( isset( $parts[1] ) ) {
 				$entry->is_plural = true;
 				$entry->plural    = $parts[1];
 			}
-			// plural translations are also separated by \0
+			// Plural translations are also separated by \0.
 			$entry->translations = explode( "\0", $translation );
 			return $entry;
 		}
 		/**

changeset 16	a86126ab1dd4
parent 9	177826044cd9
child 18	be944660c56a