Ticket #40280: 40280.2.diff

src/wp-includes/class-wp-short-circuit-result.php

@@ +1 @@
+<?php
+/**
+ * Plugin API: WP_Short_Circuit_Result class
+ *
+ * @package WordPress
+ * @since 4.9.0
+ */
+
+/**
+ * Core class to store a short-circuit result.
+ *
+ * An instance of this class can be passed to an action to determine whether the surrounding
+ * function or method should be short-circuited, and optionally define a return value.
+ *
+ * @since 4.9.0
+ */
+class WP_Short_Circuit_Result {
+
+        /**
+         * Whether the current process should be short-circuited.
+         *
+         * @since 4.9.0
+         * @access private
+         * @var bool
+         */
+        private $short_circuit = false;
+
+        /**
+         * Value of the short-circuit.
+         *
+         * @since 4.9.0
+         * @access private
+         * @var mixed
+         */
+        private $value = null;
+
+        /**
+         * Toggles or retrieves whether the current process should be short-circuited.
+         *
+         * @since 4.9.0
+         * @access public
+         *
+         * @param bool $set Optional. Whether to short-circuit the current process. If this is
+         *                  omitted, the current value is retrieved. Default null.
+         * @return bool The previous value of the short-circuit flag if $set was passed, or the
+         *              current value of the flag otherwise.
+         */
+        public function short_circuit( $set = null ) {
+                $current = $this->short_circuit;
+
+                if ( func_num_args() > 0 ) {
+                        $this->short_circuit = (bool) $set;
+                }
+
+                return $current;
+        }
+
+        /**
+         * Sets or retrieves the result value of the short-circuit.
+         *
+         * @since 4.9.0
+         * @access public
+         *
+         * @param bool $set Optional. Result value of the short-circuit. If this is
+         *                  omitted, the current value is retrieved. Default null.
+         * @return bool The previous short-circuit result value if $set was passed, or the
+         *              current result value otherwise.
+         */
+        public function value( $set = null ) {
+                $current = $this->value;
+
+                if ( func_num_args() > 0 ) {
+                        $this->value = $set;
+                }
+
+                return $current;
+        }
+}

src/wp-settings.php

@@ -18 +18 @@
 // Include files required for initialization.
 require( ABSPATH . WPINC . '/load.php' );
 require( ABSPATH . WPINC . '/default-constants.php' );
+require_once( ABSPATH . WPINC . '/class-wp-short-circuit-result.php' );
 require_once( ABSPATH . WPINC . '/plugin.php' );
 
 /*