url(123);// возвращает урл страницы, page_id идентификатор которой равен 123
url(123, 1);// возвращает тип урл страницы, page_id идентификатор которой равен 123
url (123);// пример выполнения в любом месте скриптов
Если вы уже знаете url и url_type страницы, то чтобы не делать лишний запрос в базе данных, можно просто передать url, url_type в функцию и получить урл страницы. Приведу пример подобного случая:
$r = @mysql_fetch_assoc( mysql_query( sql('url, url_type, name', 'page_id=123')));// узнаем имя страницы у которой page_id = 123
$url = url($r);// т.к. массив $r содержит данные url, url_type, то просто передадим их в функцию url и узнаем урл страницы