datasift / storyplayer

     *         the name of the table to use

     * @return void

     */

    public function removeTable($tableName)

    {

        // what are we doing?

        $log = Log::usingLog()->startAction("remove table '{$tableName}' from the runtime tables");

        // does the table exist?

        if (!RuntimeTable::fromRuntimeTables()->getTableExists($tableName)) {

            $log->endAction();

            return;

        }

        // get the tables

        $tables = RuntimeTable::fromRuntimeTables()->getAllTablesSilently();

        unset($tables->$tableName);

        // all done

        $log->endAction("table '{$tableName}' removed");

    }

    /**

     * remove a table if, and only if, it is empty

     *         the name of the table to remove

     * @return void

     */

    public function removeTableIfEmpty($tableName)

    {

        // what are we doing?

        $log = Log::usingLog()->startAction("remove table '{$tableName}' from the runtime tables if it is empty");

        // is the table empty?

        if (!RuntimeTable::fromRuntimeTable($tableName)->getIsEmpty()) {

            $log->endAction("not removing; table is not empty");

            return;

        }

        // if we get here, the table is empty

        $tables = RuntimeTable::fromRuntimeTables()->getAllTablesSilently();

        unset($tables->$tableName);

        // all done

        $log->endAction("table '{$tableName}' removed; table was empty");

    }

}