SplHeap::top()函数—用法及示例

函数名称：SplHeap::top()

适用版本：PHP 5 >= 5.3.0, PHP 7

函数描述：SplHeap::top() 方法用于获取堆中具有最高优先级的元素，而不会从堆中删除它。

语法：public mixed SplHeap::top ( void )

参数：此函数没有参数。

返回值：返回具有最高优先级的元素。

示例：

// 创建一个堆
$heap = new SplMaxHeap();

// 向堆中添加元素
$heap->insert('apple');
$heap->insert('banana');
$heap->insert('orange');

// 获取具有最高优先级的元素
$topElement = $heap->top();

// 输出结果
echo $topElement; // 输出：orange

注意：SplHeap 类是一个抽象类，不能直接实例化。因此，我们使用其子类 SplMaxHeap 来创建堆。在示例中，我们创建了一个 SplMaxHeap 堆，并使用 insert() 方法向堆中添加了几个元素。然后，通过调用 top() 方法，我们获取了具有最高优先级的元素，并将其输出。在这个例子中，元素 'orange' 具有最高优先级，因此它被输出。

请注意，如果堆为空时调用 top() 方法，将会抛出一个 RuntimeException 异常。因此，在使用 top() 方法之前，最好先使用 isEmpty() 方法检查堆是否为空。