<h2>File Contents: /home/planet5/public_html/yanhuanghealthcare.co.uk/wp-includes/l10n/class-wp-translation-file.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/yanhuanghealthcare.co.uk/wp-includes/l10n/class-wp-translation-file.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * I18N: WP_Translation_File class.
 *
 * @package WordPress
 * @subpackage I18N
 * @since 6.5.0
 */

/**
 * Class WP_Translation_File.
 *
 * @since 6.5.0
 */
abstract class WP_Translation_File {
	/**
	 * List of headers.
	 *
	 * @since 6.5.0
	 * @var array&lt;string, string&gt;
	 */
	protected $headers = array();

	/**
	 * Whether file has been parsed.
	 *
	 * @since 6.5.0
	 * @var bool
	 */
	protected $parsed = false;

	/**
	 * Error information.
	 *
	 * @since 6.5.0
	 * @var string|null Error message or null if no error.
	 */
	protected $error;

	/**
	 * File name.
	 *
	 * @since 6.5.0
	 * @var string
	 */
	protected $file = &#039;&#039;;

	/**
	 * Translation entries.
	 *
	 * @since 6.5.0
	 * @var array&lt;string, string&gt;
	 */
	protected $entries = array();

	/**
	 * Plural forms function.
	 *
	 * @since 6.5.0
	 * @var callable|null Plural forms.
	 */
	protected $plural_forms = null;

	/**
	 * Constructor.
	 *
	 * @since 6.5.0
	 *
	 * @param string $file File to load.
	 */
	protected function __construct( string $file ) {
		$this-&gt;file = $file;
	}

	/**
	 * Creates a new WP_Translation_File instance for a given file.
	 *
	 * @since 6.5.0
	 *
	 * @param string      $file     File name.
	 * @param string|null $filetype Optional. File type. Default inferred from file name.
	 * @return false|WP_Translation_File
	 */
	public static function create( string $file, ?string $filetype = null ) {
		if ( ! is_readable( $file ) ) {
			return false;
		}

		if ( null === $filetype ) {
			$pos = strrpos( $file, &#039;.&#039; );
			if ( false !== $pos ) {
				$filetype = substr( $file, $pos + 1 );
			}
		}

		switch ( $filetype ) {
			case &#039;mo&#039;:
				return new WP_Translation_File_MO( $file );
			case &#039;php&#039;:
				return new WP_Translation_File_PHP( $file );
			default:
				return false;
		}
	}

	/**
	 * Creates a new WP_Translation_File instance for a given file.
	 *
	 * @since 6.5.0
	 *
	 * @param string $file     Source file name.
	 * @param string $filetype Desired target file type.
	 * @return string|false Transformed translation file contents on success, false otherwise.
	 */
	public static function transform( string $file, string $filetype ) {
		$source = self::create( $file );

		if ( false === $source ) {
			return false;
		}

		switch ( $filetype ) {
			case &#039;mo&#039;:
				$destination = new WP_Translation_File_MO( &#039;&#039; );
				break;
			case &#039;php&#039;:
				$destination = new WP_Translation_File_PHP( &#039;&#039; );
				break;
			default:
				return false;
		}

		$success = $destination-&gt;import( $source );

		if ( ! $success ) {
			return false;
		}

		return $destination-&gt;export();
	}

	/**
	 * Returns all headers.
	 *
	 * @since 6.5.0
	 *
	 * @return array&lt;string, string&gt; Headers.
	 */
	public function headers(): array {
		if ( ! $this-&gt;parsed ) {
			$this-&gt;parse_file();
		}
		return $this-&gt;headers;
	}

	/**
	 * Returns all entries.
	 *
	 * @since 6.5.0
	 *
	 * @return array&lt;string, string[]&gt; Entries.
	 */
	public function entries(): array {
		if ( ! $this-&gt;parsed ) {
			$this-&gt;parse_file();
		}

		return $this-&gt;entries;
	}

	/**
	 * Returns the current error information.
	 *
	 * @since 6.5.0
	 *
	 * @return string|null Error message or null if no error.
	 */
	public function error() {
		return $this-&gt;error;
	}

	/**
	 * Returns the file name.
	 *
	 * @since 6.5.0
	 *
	 * @return string File name.
	 */
	public function get_file(): string {
		return $this-&gt;file;
	}

	/**
	 * Translates a given string.
	 *
	 * @since 6.5.0
	 *
	 * @param string $text String to translate.
	 * @return false|string Translation(s) on success, false otherwise.
	 */
	public function translate( string $text ) {
		if ( ! $this-&gt;parsed ) {
			$this-&gt;parse_file();
		}

		return $this-&gt;entries[ $text ] ?? false;
	}

	/**
	 * Returns the plural form for a given number.
	 *
	 * @since 6.5.0
	 *
	 * @param int $number Count.
	 * @return int Plural form.
	 */
	public function get_plural_form( int $number ): int {
		if ( ! $this-&gt;parsed ) {
			$this-&gt;parse_file();
		}

		if ( null === $this-&gt;plural_forms &amp;&amp; isset( $this-&gt;headers[&#039;plural-forms&#039;] ) ) {
			$expression         = $this-&gt;get_plural_expression_from_header( $this-&gt;headers[&#039;plural-forms&#039;] );
			$this-&gt;plural_forms = $this-&gt;make_plural_form_function( $expression );
		}

		if ( is_callable( $this-&gt;plural_forms ) ) {
			/**
			 * Plural form.
			 *
			 * @var int $result Plural form.
			 */
			$result = call_user_func( $this-&gt;plural_forms, $number );

			return $result;
		}

		// Default plural form matches English, only &quot;One&quot; is considered singular.
		return ( 1 === $number ? 0 : 1 );
	}

	/**
	 * Returns the plural forms expression as a tuple.
	 *
	 * @since 6.5.0
	 *
	 * @param string $header Plural-Forms header string.
	 * @return string Plural forms expression.
	 */
	protected function get_plural_expression_from_header( string $header ): string {
		if ( preg_match( &#039;/^\s*nplurals\s*=\s*(\d+)\s*;\s+plural\s*=\s*(.+)$/&#039;, $header, $matches ) ) {
			return trim( $matches[2] );
		}

		return &#039;n != 1&#039;;
	}

	/**
	 * Makes a function, which will return the right translation index, according to the
	 * plural forms header.
	 *
	 * @since 6.5.0
	 *
	 * @param string $expression Plural form expression.
	 * @return callable(int $num): int Plural forms function.
	 */
	protected function make_plural_form_function( string $expression ): callable {
		try {
			$handler = new Plural_Forms( rtrim( $expression, &#039;;&#039; ) );
			return array( $handler, &#039;get&#039; );
		} catch ( Exception $e ) {
			// Fall back to default plural-form function.
			return $this-&gt;make_plural_form_function( &#039;n != 1&#039; );
		}
	}

	/**
	 * Imports translations from another file.
	 *
	 * @since 6.5.0
	 *
	 * @param WP_Translation_File $source Source file.
	 * @return bool True on success, false otherwise.
	 */
	protected function import( WP_Translation_File $source ): bool {
		if ( null !== $source-&gt;error() ) {
			return false;
		}

		$this-&gt;headers = $source-&gt;headers();
		$this-&gt;entries = $source-&gt;entries();
		$this-&gt;error   = $source-&gt;error();

		return null === $this-&gt;error;
	}

	/**
	 * Parses the file.
	 *
	 * @since 6.5.0
	 */
	abstract protected function parse_file();

	/**
	 * Exports translation contents as a string.
	 *
	 * @since 6.5.0
	 *
	 * @return string Translation file contents.
	 */
	abstract public function export();
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fyanhuanghealthcare.co.uk%2Fwp-includes%2Fl10n'>⬅ Back to Directory</a>