Ticket #10441: 10441-new-functions.php

<?php
/**
 * Marks an action/filter hook as deprecated and informs when it has been used.
 *
 * @access private
 *
 * @param string $tag The hook that was used
 * @param string $version The version of WordPress that deprecated the hook
 * @param string $replacement Optional. The hook that should have been used
 */
function _deprecated_hook( $tag, $version, $replacement = null ) {
        if ( WP_DEBUG && apply_filters( 'deprecated_hook_trigger_error', true ) ) {
                if ( ! is_null( $replacement ) )
                        trigger_error( sprintf( __('The %1$s hook is <strong>deprecated</strong>! Use %3$s instead.'), $tag, $version, $replacement ) );
                else
                        trigger_error( sprintf( __('The %1$s hook is <strong>deprecated</strong> since version %2$s with no alternative available.'), $tag, $version ) );
        }
}

/**
 * Call the functions hooked to a deprecated filter hook
 *
 * This function invokes do_filter() but first issues a warning that
 * a deprecated hook is being used
 *
 * @access private
 *
 * @param string $tag The name of the deprecated action to be executed.
 * @param mixed $value The value on which the filters hooked to <tt>$tag</tt> are applied on.
 * @param string $version The version of WordPress that deprecated the action
 * @param string $replacement The recommended hook to be used instead
 * @param mixed $var,... Additional variables, see apply_filters()
 * @return null Will return null if $tag does not exist in $wp_filter array
 */
function _apply_deprecated_filters( $tag, $value, $version, $replacement = null ) {
        if ( isset( $GLOBALS['wp_filter'][$tag] ) )
                _deprecated_hook( $tag, $version, $replacement );
        
        $args = array( $tag, $value );
        for ( $a = 4, $n = func_num_args() ; $a < $n; $a++ )
                $args[] = func_get_arg( $a );
        
        call_user_func_array( 'apply_filters', $args );
}

/**
 * Execute functions hooked on a deprecated action hook
 *
 * This function invokes do_action() but first issues a warning that
 * a deprecated hook is being used
 *
 * @access private
 *
 * @param string $tag The name of the deprecated action to be executed.
 * @param string $version The version of WordPress that deprecated the action
 * @param string $replacement The recommended hook to be used instead
 * @param mixed $arg Optional additional arguments, if multiple then must be an array
 */
function _do_deprecated_action( $tag, $version, $replacement = null, $arg = '' ) {
        if ( isset( $GLOBALS['wp_filter'][$tag] ) )
                _deprecated_hook( $tag, $version, $replacement );
        
        do_action( $tag, $arg );
}
?>