API15:JTable/store

This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Description

Inserts a new row if id is zero or updates an existing row in the database table

Syntax

store($updateNulls=false)

Parameter Name	Default Value	Description
$updateNulls	false	If false, null object variables are not updated

Returns

null|string null if successful otherwise returns and error message

Defined in

libraries/joomla/database/table.php

Importing

jimport( 'joomla.database.table' );

Source Body

function store( $updateNulls=false )
{
        $k = $this->_tbl_key;
 
        if( $this->$k)
        {
                $ret = $this->_db->updateObject( $this->_tbl, $this, $this->_tbl_key, $updateNulls );
        }
        else
        {
                $ret = $this->_db->insertObject( $this->_tbl, $this, $this->_tbl_key );
        }
        if( !$ret )
        {
                $this->setError(get_class( $this ).'::store failed - '.$this->_db->getErrorMsg());
                return false;
        }
        else
        {
                return true;
        }
}

Examples

<CodeExamplesForm />