A função verifica se uma categoria é a categoria pai para outra categoria.
Na função passa dois parâmetros, $cat1 e $cat2.
1 cat_is_ancestor_of( $cat1, $cat2);

$cat1 – é um número inteiro, ID da categoria que vamos verificar como categoria pai

$cat1 – é um número inteiro, ID da categoria que vamos verificar como categoria filho

A função retorna true ou false.

Acho que não precisa nem de exemplos, uma função muito fácil de compreender.