ob_end_clean

(PHP 4, PHP 5)

ob_end_clean — Limpiar (eliminar) el búfer de salida y deshabilitar el almacenamiento en el mismo

Descripción

bool ob_end_clean ( void )

Esta función desecha el contenido del búfer de salida en cola y lo desactiva. Si fuera necesario continuar procesando el contenido del búfer, se ha de llamar a ob_get_contents() antes que a ob_end_clean(), ya que el contenido del búfer es desechado cuando se llama a ob_end_clean().

El búfer de salida debe estar iniciado por ob_start() con los indicadores PHP_OUTPUT_HANDLER_CLEANABLE y PHP_OUTPUT_HANDLER_REMOVABLE. Si no, ob_end_clean() no funcionará.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error. Entre las posibles razones de un fallo se encuentra llamar a la función sin un búfer activo, o que por algún motivo no se pueda eliminar un búfer (posible en el caso de búferes especiales).

Errores/Excepciones

Si la función falla, genera un error de nivel E_NOTICE.

Ejemplos

El siguiente ejemplo muestra una forma sencilla de deshacerse de todos los búferes de salida:

Ejemplo #1 Ejemplo de ob_end_clean()

<?php
ob_start();
echo 'Texto que no será mostrado.';
ob_end_clean();
?>

Ver también