====== save ======
~~NOTOC~~
<WRAP right box>
== Syntax ==
  bool save()
</WRAP>
===== Description =====
To insert a new record into the database, change an object's properties and then call the save() method.
The method saves a record by executing an INSERT or UPDATE SQL statement as appropriate.

==== Returns ====

^Value^Description^
|0|An insert or update was unsuccessful|
|1|An insert or update was successful|
|-1|In the case of an update, and no data was modified|

===== Usage =====
<code php>
$person = new person();
$person->name_first = 'Andi';
$person->name_last  = 'Gutmans';
$person->save();
</code>