Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use WP_List_Util::sort() instead.

WP_List_Util::sort_callback( object|array $a, object|array $b ): int

Callback to sort an array by specific fields.


Description

Top ↑

See also


Top ↑

Parameters

$a object|array Required
One object to compare.
$b object|array Required
The other object to compare.

Top ↑

Return

int 0 if both objects equal. -1 if second object should come first, 1 otherwise.


Top ↑

Source

File: wp-includes/class-wp-list-util.php. View all references

private function sort_callback( $a, $b ) {
	if ( empty( $this->orderby ) ) {
		return 0;
	}

	$a = (array) $a;
	$b = (array) $b;

	foreach ( $this->orderby as $field => $direction ) {
		if ( ! isset( $a[ $field ] ) || ! isset( $b[ $field ] ) ) {
			continue;
		}

		if ( $a[ $field ] == $b[ $field ] ) {
			continue;
		}

		$results = 'DESC' === $direction ? array( 1, -1 ) : array( -1, 1 );

		if ( is_numeric( $a[ $field ] ) && is_numeric( $b[ $field ] ) ) {
			return ( $a[ $field ] < $b[ $field ] ) ? $results[0] : $results[1];
		}

		return 0 > strcmp( $a[ $field ], $b[ $field ] ) ? $results[0] : $results[1];
	}

	return 0;
}

Top ↑

Changelog

Changelog
Version Description
4.7.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.