WordPress at a glance
function is not described

separate_comments() WP 2.7.0

Separates an array of comments into an array keyed by comment_type.

No Hooks.

Return

Array. Array of comments keyed by comment_type.

Usage

separate_comments( &$comments );
$comments(array) (required)
Array of comments

Code of separate comments: wp-includes/comment.php VER 5.0.3

<?php
function separate_comments(&$comments) {
	$comments_by_type = array('comment' => array(), 'trackback' => array(), 'pingback' => array(), 'pings' => array());
	$count = count($comments);
	for ( $i = 0; $i < $count; $i++ ) {
		$type = $comments[$i]->comment_type;
		if ( empty($type) )
			$type = 'comment';
		$comments_by_type[$type][] = &$comments[$i];
		if ( 'trackback' == $type || 'pingback' == $type )
			$comments_by_type['pings'][] = &$comments[$i];
	}

	return $comments_by_type;
}