Browse: Home / Functions /

learndash_ob_get_clean

learndash_ob_get_clean( int $level )

Helper function for PHP output buffering.


Description #

Cleans nested output buffers down to a specified level. The loop counter prevents infinite loops by limiting iterations to 10, providing a safety mechanism in case of unexpected buffer handling issues.

Example usage:

$initial_level = ob_get_level(); // Level 1.

ob_start();
echo 'Outer content';            // Level 2.

ob_start();
echo 'Middle content';           // Level 3.

ob_start();
echo 'Inner content';            // Level 4.

// Clean all buffers down to level 1 (return to initial level).
$content = learndash_ob_get_clean( $initial_level );
// Returns: 'Outer content' (the last/outermost buffer cleaned).

// Clean only down to level 2 (leave the outer buffer).
$content = learndash_ob_get_clean( 2 );
// Returns: 'Middle content' (the last buffer cleaned before stopping).

Parameters #

$level

(int) (Optional) The target buffer level to stop at. Default 0 (clean all buffers).


Return #

(string) Content from the last (outermost) buffer that was cleaned, or empty string if no buffers were cleaned.


Source #

File: includes/ld-misc-functions.php


Changelog #

Changelog
Version Description
2.1.0 Introduced.