====== belongsTo ======
<WRAP alert>
This function is deprecated. Use ClassBelongsTo/TableBelongsTo/TableKeyBelongsTo instead.
</WRAP>
~~NOTOC~~
<WRAP right box>
==Syntax==
  void belongsTo(
    string $relationName, 
    string $foreignKey, 
    optional string $parentPrimaryKey = 'id'
    )
</WRAP>
===== Description =====
This function is the older way to define the parent of the current object.
===== Usage =====
In this example, we have a child table children, and a parent table person. We have a link children.person_id = persons.id. We create a child first, then link it to the parent:
<code php>
class Child extends ADOdb_Active_Record{};
$ch = new Child('children',array('id'));
/*
* this can be simplified to $ch->BelongsTo('person')
* as foreign key defaults to $table.'_id' and
* parent pkey defaults to 'id'
*/
$ch->BelongsTo('person','person_id','id');  
$ch->Load('id=1');
$p = $ch->person;
if (!$p || $p->name_first != 'John') 
    echo "Error loading belongsTo<br>";
else 
    echo "OK loading BelongTo<br>";
</code>