WP_MatchesMapRegex

14#[AllowDynamicProperties]15class WP_MatchesMapRegex {16	/**17	 * store for matches18	 *19	 * @var array20	 */21	private $_matches;22 23	/**24	 * store for mapping result25	 *26	 * @var string27	 */28	public $output;29 30	/**31	 * subject to perform mapping on (query string containing $matches[] references32	 *33	 * @var string34	 */35	private $_subject;36 37	/**38	 * regexp pattern to match $matches[] references39	 *40	 * @var string41	 */42	public $_pattern = '(\$matches\[[1-9]+[0-9]*\])'; // Magic number.43 44	/**45	 * constructor46	 *47	 * @param string $subject subject if regex48	 * @param array  $matches data to use in map49	 */50	public function __construct( $subject, $matches ) {51		$this->_subject = $subject;52		$this->_matches = $matches;53		$this->output   = $this->_map();54	}55 56	/**57	 * Substitute substring matches in subject.58	 *59	 * static helper function to ease use60	 *61	 * @param string $subject subject62	 * @param array  $matches data used for substitution63	 * @return string64	 */65	public static function apply( $subject, $matches ) {66		$result = new WP_MatchesMapRegex( $subject, $matches );67		return $result->output;68	}69 70	/**71	 * do the actual mapping72	 *73	 * @return string74	 */75	private function _map() {76		$callback = array( $this, 'callback' );77		return preg_replace_callback( $this->_pattern, $callback, $this->_subject );78	}79 80	/**81	 * preg_replace_callback hook82	 *83	 * @param array $matches preg_replace regexp matches84	 * @return string85	 */86	public function callback( $matches ) {87		$index = (int) substr( $matches[0], 9, -1 );88		return ( isset( $this->_matches[ $index ] ) ? urlencode( $this->_matches[ $index ] ) : '' );89	}90}