FM / Zend

/opt/cpanel/ea-php84/root/usr/include/php/Zend/

/opt/cpanel/ea-php84/root/usr/include/php/Zend

Name	Size	Mode	Actions
Optimizer/	-	0755	rm
zend.h	17758	0644	edit dl rm
zend_alloc.h	20701	0644	edit dl rm
zend_alloc_sizes.h	2629	0644	edit dl rm
zend_API.h	108956	0644	edit dl rm
zend_arena.h	6081	0644	edit dl rm
zend_ast.h	13789	0644	edit dl rm
zend_atomic.h	13081	0644	edit dl rm
zend_attributes.h	5913	0644	edit dl rm
zend_attributes_arginfo.h	14522	0644	edit dl rm
zend_bitset.h	8083	0644	edit dl rm
zend_build.h	1626	0644	edit dl rm
zend_builtin_functions.h	1573	0644	edit dl rm
zend_builtin_functions_arginfo.h	15229	0644	edit dl rm
zend_call_stack.h	3100	0644	edit dl rm
zend_closures.h	2315	0644	edit dl rm
zend_closures_arginfo.h	2064	0644	edit dl rm
zend_compile.h	53450	0644	edit dl rm
zend_config.h	32	0644	edit dl rm
zend_constants.h	7128	0644	edit dl rm
zend_constants_arginfo.h	1893	0644	edit dl rm
zend_cpuinfo.h	9513	0644	edit dl rm
zend_dtrace.h	2051	0644	edit dl rm
zend_enum.h	2928	0644	edit dl rm
zend_enum_arginfo.h	1691	0644	edit dl rm
zend_errors.h	2416	0644	edit dl rm
zend_exceptions.h	4648	0644	edit dl rm
zend_exceptions_arginfo.h	17678	0644	edit dl rm
zend_execute.h	23964	0644	edit dl rm
zend_extensions.h	6588	0644	edit dl rm
zend_fibers.h	5412	0644	edit dl rm
zend_fibers_arginfo.h	3530	0644	edit dl rm
zend_float.h	15468	0644	edit dl rm
zend_frameless_function.h	5518	0644	edit dl rm
zend_gc.h	4688	0644	edit dl rm
zend_gdb.h	1420	0644	edit dl rm
zend_generators.h	7664	0644	edit dl rm
zend_generators_arginfo.h	2889	0644	edit dl rm
zend_globals.h	10004	0644	edit dl rm
zend_globals_macros.h	2841	0644	edit dl rm
zend_hash.h	51567	0644	edit dl rm
zend_highlight.h	2321	0644	edit dl rm
zend_hrtime.h	3842	0644	edit dl rm
zend_inheritance.h	3186	0644	edit dl rm
zend_ini.h	12163	0644	edit dl rm
zend_ini_parser.h	3565	0644	edit dl rm
zend_ini_scanner.h	1978	0644	edit dl rm
zend_ini_scanner_defs.h	206	0644	edit dl rm
zend_interfaces.h	4118	0644	edit dl rm
zend_interfaces_arginfo.h	7839	0644	edit dl rm
zend_iterators.h	3901	0644	edit dl rm
zend_language_parser.h	10964	0644	edit dl rm
zend_language_scanner.h	3071	0644	edit dl rm
zend_language_scanner_defs.h	265	0644	edit dl rm
zend_lazy_objects.h	4719	0644	edit dl rm
zend_list.h	3483	0644	edit dl rm
zend_llist.h	4032	0644	edit dl rm
zend_long.h	4227	0644	edit dl rm
zend_map_ptr.h	3571	0644	edit dl rm
zend_max_execution_timer.h	1484	0644	edit dl rm
zend_mmap.h	1512	0644	edit dl rm
zend_modules.h	4826	0644	edit dl rm
zend_multibyte.h	4946	0644	edit dl rm
zend_multiply.h	10302	0644	edit dl rm
zend_objects.h	1941	0644	edit dl rm
zend_objects_API.h	5607	0644	edit dl rm
zend_object_handlers.h	18085	0644	edit dl rm
zend_observer.h	9036	0644	edit dl rm
zend_operators.h	34059	0644	edit dl rm
zend_portability.h	27445	0644	edit dl rm
zend_property_hooks.h	1824	0644	edit dl rm
zend_ptr_stack.h	4321	0644	edit dl rm
zend_range_check.h	3000	0644	edit dl rm
zend_signal.h	4105	0644	edit dl rm
zend_smart_str.h	7045	0644	edit dl rm
zend_smart_string.h	4207	0644	edit dl rm
zend_smart_string_public.h	1240	0644	edit dl rm
zend_smart_str_public.h	1222	0644	edit dl rm
zend_sort.h	1560	0644	edit dl rm
zend_stack.h	2442	0644	edit dl rm
zend_stream.h	3641	0644	edit dl rm
zend_string.h	22693	0644	edit dl rm
zend_strtod.h	2344	0644	edit dl rm
zend_strtod_int.h	2874	0644	edit dl rm
zend_system_id.h	1424	0644	edit dl rm
zend_types.h	52285	0644	edit dl rm
zend_type_info.h	4544	0644	edit dl rm
zend_variables.h	3088	0644	edit dl rm
zend_verify_type_inference.h	8262	0644	edit dl rm
zend_virtual_cwd.h	13217	0644	edit dl rm
zend_vm.h	2112	0644	edit dl rm
zend_vm_def.h	302809	0644	edit dl rm
zend_vm_execute.h	2278009	0644	edit dl rm
zend_vm_handlers.h	92711	0644	edit dl rm
zend_vm_opcodes.h	13819	0644	edit dl rm
zend_vm_trace_handlers.h	3216	0644	edit dl rm
zend_vm_trace_lines.h	1755	0644	edit dl rm
zend_vm_trace_map.h	2665	0644	edit dl rm
zend_weakrefs.h	3226	0644	edit dl rm
zend_weakrefs_arginfo.h	3440	0644	edit dl rm

Edit: /opt/cpanel/ea-php84/root/usr/include/php/Zend/zend_generators.h (7664B)

/*
   +----------------------------------------------------------------------+
   | Zend Engine                                                          |
   +----------------------------------------------------------------------+
   | Copyright (c) Zend Technologies Ltd. (http://www.zend.com)           |
   +----------------------------------------------------------------------+
   | This source file is subject to version 2.00 of the Zend license,     |
   | that is bundled with this package in the file LICENSE, and is        |
   | available through the world-wide-web at the following url:           |
   | http://www.zend.com/license/2_00.txt.                                |
   | If you did not receive a copy of the Zend license and are unable to  |
   | obtain it through the world-wide-web, please send a note to          |
   | license@zend.com so we can mail you a copy immediately.              |
   +----------------------------------------------------------------------+
   | Authors: Nikita Popov <nikic@php.net>                                |
   |          Bob Weinand <bobwei9@hotmail.com>                           |
   +----------------------------------------------------------------------+
*/

#ifndef ZEND_GENERATORS_H
#define ZEND_GENERATORS_H

#include <stdint.h>

#include "zend_compile.h"

BEGIN_EXTERN_C()

extern ZEND_API zend_class_entry *zend_ce_generator;
extern ZEND_API zend_class_entry *zend_ce_ClosedGeneratorException;

typedef struct _zend_generator_node zend_generator_node;
typedef struct _zend_generator zend_generator;

/* The concept of `yield from` exposes problems when accessed at different levels of the chain of delegated generators. We need to be able to reference the currently executed Generator in all cases and still being able to access the return values of finished Generators.
 * The solution to this problem is a doubly-linked tree, which all Generators referenced in maintain a reference to. It should be impossible to avoid walking the tree in all cases. This way, we only need tree walks from leaf to root in case where some part of the `yield from` chain is passed to another `yield from`. (Update of leaf node pointer and list of multi-children nodes needed when leaf gets a child in direct path from leaf to root node.) But only in that case, which should be a fairly rare case (which is then possible, but not totally cheap).
 * The root of the tree is then the currently executed Generator. The subnodes of the tree (all except the root node) are all Generators which do `yield from`. Each node of the tree knows a pointer to one leaf descendant node. Each node with multiple children needs a list of all leaf descendant nodes paired with pointers to their respective child node. (The stack is determined by leaf node pointers) Nodes with only one child just don't need a list, there it is enough to just have a pointer to the child node. Further, leaf nodes store a pointer to the root node.
 * That way, when we advance any generator, we just need to look up a leaf node (which all have a reference to a root node). Then we can see at the root node whether current Generator is finished. If it isn't, all is fine and we can just continue. If the Generator finished, there will be two cases. Either it is a simple node with just one child, then go down to child node. Or it has multiple children and we now will remove the current leaf node from the list of nodes (unnecessary, is microoptimization) and go down to the child node whose reference was paired with current leaf node. Child node is then removed its parent reference and becomes new top node. Or the current node references the Generator we're currently executing, then we can continue from the YIELD_FROM opcode. When a node referenced as root node in a leaf node has a parent, then we go the way up until we find a root node without parent.
 * In case we go into a new `yield from` level, a node is created on top of current root and becomes the new root. Leaf node needs to be updated with new root node then.
 * When a Generator referenced by a node of the tree is added to `yield from`, that node now gets a list of children (we need to walk the descendants of that node and nodes of the tree of the other Generator down to the first multi-children node and copy all the leaf node pointers from there). In case there was no multi-children node (linear tree), we just add a pair (pointer to leaf node, pointer to child node), with the child node being in a direct path from leaf to this node.
 */

struct _zend_generator_node {
	zend_generator *parent; /* NULL for root */
	uint32_t children;
	union {
		HashTable *ht; /* if multiple children */
		zend_generator *single; /* if one child */
	} child;
	/* One generator can cache a direct pointer to the current root.
	 * The leaf member points back to the generator using the root cache. */
	union {
		zend_generator *leaf; /* if parent != NULL */
		zend_generator *root; /* if parent == NULL */
	} ptr;
};

struct _zend_generator {
	zend_object std;

/* The suspended execution context. */
	zend_execute_data *execute_data;

/* Frozen call stack for "yield" used in context of other calls */
	zend_execute_data *frozen_call_stack;

/* Current value */
	zval value;
	/* Current key */
	zval key;
	/* Return value */
	zval retval;
	/* Variable to put sent value into */
	zval *send_target;
	/* Largest used integer key for auto-incrementing keys */
	zend_long largest_used_integer_key;

/* Values specified by "yield from" to yield from this generator.
	 * This is only used for arrays or non-generator Traversables.
	 * This zval also uses the u2 structure in the same way as
	 * by-value foreach. */
	zval values;

/* Node of waiting generators when multiple "yield from" expressions
	 * are nested. */
	zend_generator_node node;

/* Fake execute_data for stacktraces */
	zend_execute_data execute_fake;

/* The underlying function, equivalent to execute_data->func while
	 * the generator is alive. */
	zend_function *func;

/* ZEND_GENERATOR_* flags */
	uint8_t flags;
};

static const uint8_t ZEND_GENERATOR_CURRENTLY_RUNNING = 0x1;
static const uint8_t ZEND_GENERATOR_FORCED_CLOSE      = 0x2;
static const uint8_t ZEND_GENERATOR_AT_FIRST_YIELD    = 0x4;
static const uint8_t ZEND_GENERATOR_DO_INIT           = 0x8;
static const uint8_t ZEND_GENERATOR_IN_FIBER          = 0x10;

void zend_register_generator_ce(void);
ZEND_API void zend_generator_close(zend_generator *generator, bool finished_execution);
ZEND_API void zend_generator_resume(zend_generator *generator);

ZEND_API void zend_generator_restore_call_stack(zend_generator *generator);
ZEND_API zend_execute_data* zend_generator_freeze_call_stack(zend_execute_data *execute_data);

void zend_generator_yield_from(zend_generator *generator, zend_generator *from);
ZEND_API zend_execute_data *zend_generator_check_placeholder_frame(zend_execute_data *ptr);

ZEND_API zend_generator *zend_generator_update_current(zend_generator *generator);
ZEND_API zend_generator *zend_generator_update_root(zend_generator *generator);
static zend_always_inline zend_generator *zend_generator_get_current(zend_generator *generator)
{
	if (EXPECTED(generator->node.parent == NULL)) {
		/* we're not in yield from mode */
		return generator;
	}

zend_generator *root = generator->node.ptr.root;
	if (!root) {
		root = zend_generator_update_root(generator);
	}

if (EXPECTED(root->execute_data)) {
		/* generator still running */
		return root;
	}

return zend_generator_update_current(generator);
}

HashTable *zend_generator_frame_gc(zend_get_gc_buffer *gc_buffer, zend_generator *generator);

END_EXTERN_C()

#endif

cmd: