<?php

< 


/**

<   @version   v5.20.16  12-Jan-2020
<   @copyright (c) 2000-2013 John Lim (jlim#natsoft.com). All rights reserved.
<   @copyright (c) 2014      Damien Regad, Mark Newnham and the ADOdb community
<   Released under both BSD license and Lesser GPL library license.
<   Whenever there is any discrepancy between the two licenses,
<   the BSD license will take precedence.
< 
<   Set tabs to 4 for best viewing.
< 
<  	DOCUMENTATION:
< 
< 		See adodb/tests/test-datadict.php for docs and examples.
< */
< 
< /*
< 	Test script for parser



>  * ADOdb Data Dictionary base class.
>  *
>  * This file is part of ADOdb, a Database Abstraction Layer library for PHP.
>  *
>  * @package ADOdb
>  * @link https://adodb.org Project's web site and documentation
>  * @link https://github.com/ADOdb/ADOdb Source code and issue tracker
>  *
>  * The ADOdb Library is dual-licensed, released under both the BSD 3-Clause
>  * and the GNU Lesser General Public Licence (LGPL) v2.1 or, at your option,
>  * any later version. This means you can use it in proprietary products.
>  * See the LICENSE.md file distributed with this source code for details.
>  * @license BSD-3-Clause
>  * @license LGPL-2.1-or-later
>  *
>  * @copyright 2000-2013 John Lim
>  * @copyright 2014 Damien Regad, Mark Newnham and the ADOdb community


*/

// security - hide paths
if (!defined('ADODB_DIR')) die();


< function Lens_ParseTest()



> /**
>  * Test script for parser
>  */
> function lens_ParseTest()


{
$str = "`zcol ACOL` NUMBER(32,2) DEFAULT 'The \"cow\" (and Jim''s dog) jumps over the moon' PRIMARY, INTI INT AUTO DEFAULT 0, zcol2\"afs ds";
print "<p>$str</p>";

< $a= Lens_ParseArgs($str);



> $a= lens_ParseArgs($str);


print "<pre>";
print_r($a);
print "</pre>";
}


if (!function_exists('ctype_alnum')) {
	function ctype_alnum($text) {
		return preg_match('/^[a-z0-9]*$/i', $text);
	}
}

//Lens_ParseTest();

/**
	Parse arguments, treat "text" (text) and 'text' as quotation marks.
	To escape, use "" or '' or ))

	Will read in "abc def" sans quotes, as: abc def
	Same with 'abc def'.
	However if `abc def`, then will read in as `abc def`

	@param endstmtchar    Character that indicates end of statement
	@param tokenchars     Include the following characters in tokens apart from A-Z and 0-9
	@returns 2 dimensional array containing parsed tokens.
*/

< function Lens_ParseArgs($args,$endstmtchar=',',$tokenchars='_.-')



> function lens_ParseArgs($args,$endstmtchar=',',$tokenchars='_.-')


{
	$pos = 0;
	$intoken = false;
	$stmtno = 0;
	$endquote = false;
	$tokens = array();
	$tokens[$stmtno] = array();
	$max = strlen($args);
	$quoted = false;
	$tokarr = array();

	while ($pos < $max) {
		$ch = substr($args,$pos,1);
		switch($ch) {
		case ' ':
		case "\t":
		case "\n":
		case "\r":
			if (!$quoted) {
				if ($intoken) {
					$intoken = false;
					$tokens[$stmtno][] = implode('',$tokarr);
				}
				break;
			}

			$tokarr[] = $ch;
			break;

		case '`':
			if ($intoken) $tokarr[] = $ch;
		case '(':
		case ')':
		case '"':
		case "'":

			if ($intoken) {
				if (empty($endquote)) {
					$tokens[$stmtno][] = implode('',$tokarr);
					if ($ch == '(') $endquote = ')';
					else $endquote = $ch;
					$quoted = true;
					$intoken = true;
					$tokarr = array();
				} else if ($endquote == $ch) {
					$ch2 = substr($args,$pos+1,1);
					if ($ch2 == $endquote) {
						$pos += 1;
						$tokarr[] = $ch2;
					} else {
						$quoted = false;
						$intoken = false;
						$tokens[$stmtno][] = implode('',$tokarr);
						$endquote = '';
					}
				} else
					$tokarr[] = $ch;

			}else {

				if ($ch == '(') $endquote = ')';
				else $endquote = $ch;
				$quoted = true;
				$intoken = true;
				$tokarr = array();
				if ($ch == '`') $tokarr[] = '`';
			}
			break;

		default:

			if (!$intoken) {
				if ($ch == $endstmtchar) {
					$stmtno += 1;
					$tokens[$stmtno] = array();
					break;
				}

				$intoken = true;
				$quoted = false;
				$endquote = false;
				$tokarr = array();

			}

			if ($quoted) $tokarr[] = $ch;
			else if (ctype_alnum($ch) || strpos($tokenchars,$ch) !== false) $tokarr[] = $ch;
			else {
				if ($ch == $endstmtchar) {
					$tokens[$stmtno][] = implode('',$tokarr);
					$stmtno += 1;
					$tokens[$stmtno] = array();
					$intoken = false;
					$tokarr = array();
					break;
				}
				$tokens[$stmtno][] = implode('',$tokarr);
				$tokens[$stmtno][] = $ch;
				$intoken = false;
			}
		}
		$pos += 1;
	}
	if ($intoken) $tokens[$stmtno][] = implode('',$tokarr);

	return $tokens;
}


class ADODB_DataDict {

> 	/** @var ADOConnection */


	var $connection;
	var $debug = false;
	var $dropTable = 'DROP TABLE %s';
	var $renameTable = 'RENAME TABLE %s TO %s';
	var $dropIndex = 'DROP INDEX %s';
	var $addCol = ' ADD';
	var $alterCol = ' ALTER COLUMN';
	var $dropCol = ' DROP COLUMN';
	var $renameColumn = 'ALTER TABLE %s RENAME COLUMN %s TO %s';	// table, old-column, new-column, column-definitions (not used by default)
	var $nameRegex = '\w';
	var $nameRegexBrackets = 'a-zA-Z0-9_\(\)';
	var $schema = false;
	var $serverInfo = array();
	var $autoIncrement = false;
	var $dataProvider;

< 	var $invalidResizeTypes4 = array('CLOB','BLOB','TEXT','DATE','TIME'); // for changetablesql



> 	var $invalidResizeTypes4 = array('CLOB','BLOB','TEXT','DATE','TIME'); // for changeTableSQL


	var $blobSize = 100; 	/// any varchar/char field this size or greater is treated as a blob

< 							/// in other words, we use a text area for editting.



> 							/// in other words, we use a text area for editing.
> 	/** @var string Uppercase driver name */
> 	var $upperName;




< 	function GetCommentSQL($table,$col)



> 	/*
> 	* Indicates whether a BLOB/CLOB field will allow a NOT NULL setting
> 	* The type is whatever is matched to an X or X2 or B type. We must
> 	* explicitly set the value in the driver to switch the behaviour on
> 	*/
> 	public $blobAllowsNotNull;
> 	/*
> 	* Indicates whether a BLOB/CLOB field will allow a DEFAULT set
> 	* The type is whatever is matched to an X or X2 or B type. We must
> 	* explicitly set the value in the driver to switch the behaviour on
> 	*/
> 	public $blobAllowsDefaultValue;
> 
> 	function getCommentSQL($table,$col)


	{
		return false;
	}


< 	function SetCommentSQL($table,$col,$cmt)



> 	function setCommentSQL($table,$col,$cmt)


	{
		return false;
	}


< 	function MetaTables()



> 	function metaTables()


	{

< 		if (!$this->connection->IsConnected()) return array();
< 		return $this->connection->MetaTables();



> 		if (!$this->connection->isConnected()) return array();
> 		return $this->connection->metaTables();


	}


< 	function MetaColumns($tab, $upper=true, $schema=false)



> 	function metaColumns($tab, $upper=true, $schema=false)


	{

< 		if (!$this->connection->IsConnected()) return array();
< 		return $this->connection->MetaColumns($this->TableName($tab), $upper, $schema);



> 		if (!$this->connection->isConnected()) return array();
> 		return $this->connection->metaColumns($this->tableName($tab), $upper, $schema);


	}


< 	function MetaPrimaryKeys($tab,$owner=false,$intkey=false)



> 	function metaPrimaryKeys($tab,$owner=false,$intkey=false)


	{

< 		if (!$this->connection->IsConnected()) return array();
< 		return $this->connection->MetaPrimaryKeys($this->TableName($tab), $owner, $intkey);



> 		if (!$this->connection->isConnected()) return array();
> 		return $this->connection->metaPrimaryKeys($this->tableName($tab), $owner, $intkey);


	}


< 	function MetaIndexes($table, $primary = false, $owner = false)



> 	function metaIndexes($table, $primary = false, $owner = false)


	{

< 		if (!$this->connection->IsConnected()) return array();
< 		return $this->connection->MetaIndexes($this->TableName($table), $primary, $owner);



> 		if (!$this->connection->isConnected()) return array();
> 		return $this->connection->metaIndexes($this->tableName($table), $primary, $owner);


	}


< 	function MetaType($t,$len=-1,$fieldobj=false)



> 	function metaType($t,$len=-1,$fieldobj=false)


	{
		static $typeMap = array(
		'VARCHAR' => 'C',
		'VARCHAR2' => 'C',
		'CHAR' => 'C',
		'C' => 'C',
		'STRING' => 'C',
		'NCHAR' => 'C',
		'NVARCHAR' => 'C',
		'VARYING' => 'C',
		'BPCHAR' => 'C',
		'CHARACTER' => 'C',
		'INTERVAL' => 'C',  # Postgres
		'MACADDR' => 'C', # postgres
		'VAR_STRING' => 'C', # mysql
		##
		'LONGCHAR' => 'X',
		'TEXT' => 'X',
		'NTEXT' => 'X',
		'M' => 'X',
		'X' => 'X',
		'CLOB' => 'X',
		'NCLOB' => 'X',
		'LVARCHAR' => 'X',
		##
		'BLOB' => 'B',
		'IMAGE' => 'B',
		'BINARY' => 'B',
		'VARBINARY' => 'B',
		'LONGBINARY' => 'B',
		'B' => 'B',
		##
		'YEAR' => 'D', // mysql
		'DATE' => 'D',
		'D' => 'D',
		##
		'UNIQUEIDENTIFIER' => 'C', # MS SQL Server
		##
		'TIME' => 'T',
		'TIMESTAMP' => 'T',
		'DATETIME' => 'T',
		'TIMESTAMPTZ' => 'T',
		'SMALLDATETIME' => 'T',
		'T' => 'T',
		'TIMESTAMP WITHOUT TIME ZONE' => 'T', // postgresql
		##
		'BOOL' => 'L',
		'BOOLEAN' => 'L',
		'BIT' => 'L',
		'L' => 'L',
		##
		'COUNTER' => 'R',
		'R' => 'R',
		'SERIAL' => 'R', // ifx
		'INT IDENTITY' => 'R',
		##
		'INT' => 'I',
		'INT2' => 'I',
		'INT4' => 'I',
		'INT8' => 'I',
		'INTEGER' => 'I',
		'INTEGER UNSIGNED' => 'I',
		'SHORT' => 'I',
		'TINYINT' => 'I',
		'SMALLINT' => 'I',
		'I' => 'I',
		##
		'LONG' => 'N', // interbase is numeric, oci8 is blob
		'BIGINT' => 'N', // this is bigger than PHP 32-bit integers
		'DECIMAL' => 'N',
		'DEC' => 'N',
		'REAL' => 'N',
		'DOUBLE' => 'N',
		'DOUBLE PRECISION' => 'N',
		'SMALLFLOAT' => 'N',
		'FLOAT' => 'N',
		'NUMBER' => 'N',
		'NUM' => 'N',
		'NUMERIC' => 'N',
		'MONEY' => 'N',

		## informix 9.2
		'SQLINT' => 'I',
		'SQLSERIAL' => 'I',
		'SQLSMINT' => 'I',
		'SQLSMFLOAT' => 'N',
		'SQLFLOAT' => 'N',
		'SQLMONEY' => 'N',
		'SQLDECIMAL' => 'N',
		'SQLDATE' => 'D',
		'SQLVCHAR' => 'C',
		'SQLCHAR' => 'C',
		'SQLDTIME' => 'T',
		'SQLINTERVAL' => 'N',
		'SQLBYTES' => 'B',
		'SQLTEXT' => 'X',
		 ## informix 10
		"SQLINT8" => 'I8',
		"SQLSERIAL8" => 'I8',
		"SQLNCHAR" => 'C',
		"SQLNVCHAR" => 'C',
		"SQLLVARCHAR" => 'X',
		"SQLBOOL" => 'L'
		);


< 		if (!$this->connection->IsConnected()) {



> 		if (!$this->connection->isConnected()) {


			$t = strtoupper($t);
			if (isset($typeMap[$t])) return $typeMap[$t];

< 			return 'N';



> 			return ADODB_DEFAULT_METATYPE;


		}

< 		return $this->connection->MetaType($t,$len,$fieldobj);



> 		return $this->connection->metaType($t,$len,$fieldobj);


	}


< 	function NameQuote($name = NULL,$allowBrackets=false)



> 	function nameQuote($name = NULL,$allowBrackets=false)


	{
		if (!is_string($name)) {

< 			return FALSE;



> 			return false;


		}

		$name = trim($name);

		if ( !is_object($this->connection) ) {
			return $name;
		}

		$quote = $this->connection->nameQuote;

		// if name is of the form `name`, quote it
		if ( preg_match('/^`(.+)`$/', $name, $matches) ) {
			return $quote . $matches[1] . $quote;
		}

		// if name contains special characters, quote it
		$regex = ($allowBrackets) ? $this->nameRegexBrackets : $this->nameRegex;

		if ( !preg_match('/^[' . $regex . ']+$/', $name) ) {
			return $quote . $name . $quote;
		}

		return $name;
	}


< 	function TableName($name)



> 	function tableName($name)


	{
		if ( $this->schema ) {

< 			return $this->NameQuote($this->schema) .'.'. $this->NameQuote($name);



> 			return $this->nameQuote($this->schema) .'.'. $this->nameQuote($name);


		}

< 		return $this->NameQuote($name);



> 		return $this->nameQuote($name);


	}


< 	// Executes the sql array returned by GetTableSQL and GetIndexSQL
< 	function ExecuteSQLArray($sql, $continueOnError = true)



> 	// Executes the sql array returned by getTableSQL and getIndexSQL
> 	function executeSQLArray($sql, $continueOnError = true)


	{
		$rez = 2;
		$conn = $this->connection;
		$saved = $conn->debug;
		foreach($sql as $line) {

			if ($this->debug) $conn->debug = true;

< 			$ok = $conn->Execute($line);



> 			$ok = $conn->execute($line);


			$conn->debug = $saved;
			if (!$ok) {

< 				if ($this->debug) ADOConnection::outp($conn->ErrorMsg());



> 				if ($this->debug) ADOConnection::outp($conn->errorMsg());


				if (!$continueOnError) return 0;
				$rez = 1;
			}
		}
		return $rez;
	}

	/**
	 	Returns the actual type given a character code.

		C:  varchar
		X:  CLOB (character large object) or largest varchar size if CLOB is not supported
		C2: Multibyte varchar
		X2: Multibyte CLOB

		B:  BLOB (binary large object)

		D:  Date
		T:  Date-time
		L:  Integer field suitable for storing booleans (0 or 1)
		I:  Integer
		F:  Floating point number
		N:  Numeric or decimal number
	*/


< 	function ActualType($meta)



> 	function actualType($meta)


	{

> 		$meta = strtoupper($meta);
		return $meta;
> 
	}
> 		/*

> 		* Add support for custom meta types. We do this
	function CreateDatabase($dbname,$options=false)
> 		* first, that allows us to override existing types
	{
> 		*/
		$options = $this->_Options($options);
> 		if (isset($this->connection->customMetaTypes[$meta]))
		$sql = array();
> 			return $this->connection->customMetaTypes[$meta]['actual'];

> 



< 	function CreateDatabase($dbname,$options=false)



> 	function createDatabase($dbname,$options=false)



< 		$options = $this->_Options($options);



> 		$options = $this->_options($options);



< 		$s = 'CREATE DATABASE ' . $this->NameQuote($dbname);



> 		$s = 'CREATE DATABASE ' . $this->nameQuote($dbname);



		$sql[] = $s;
		return $sql;
	}

	/*
	 Generates the SQL to create index. Returns an array of sql strings.
	*/

< 	function CreateIndexSQL($idxname, $tabname, $flds, $idxoptions = false)



> 	function createIndexSQL($idxname, $tabname, $flds, $idxoptions = false)


	{
		if (!is_array($flds)) {
			$flds = explode(',',$flds);
		}

		foreach($flds as $key => $fld) {
			# some indexes can use partial fields, eg. index first 32 chars of "name" with NAME(32)

< 			$flds[$key] = $this->NameQuote($fld,$allowBrackets=true);



> 			$flds[$key] = $this->nameQuote($fld,$allowBrackets=true);


		}


< 		return $this->_IndexSQL($this->NameQuote($idxname), $this->TableName($tabname), $flds, $this->_Options($idxoptions));



> 		return $this->_indexSQL($this->nameQuote($idxname), $this->tableName($tabname), $flds, $this->_options($idxoptions));


	}


< 	function DropIndexSQL ($idxname, $tabname = NULL)



> 	function dropIndexSQL ($idxname, $tabname = NULL)


	{

< 		return array(sprintf($this->dropIndex, $this->NameQuote($idxname), $this->TableName($tabname)));



> 		return array(sprintf($this->dropIndex, $this->nameQuote($idxname), $this->tableName($tabname)));


	}


< 	function SetSchema($schema)



> 	function setSchema($schema)


	{
		$this->schema = $schema;
	}


< 	function AddColumnSQL($tabname, $flds)



> 	function addColumnSQL($tabname, $flds)


	{

< 		$tabname = $this->TableName ($tabname);



> 		$tabname = $this->tableName($tabname);


		$sql = array();

< 		list($lines,$pkey,$idxs) = $this->_GenFields($flds);



> 		list($lines,$pkey,$idxs) = $this->_genFields($flds);


		// genfields can return FALSE at times
		if ($lines  == null) $lines = array();
		$alter = 'ALTER TABLE ' . $tabname . $this->addCol . ' ';
		foreach($lines as $v) {
			$sql[] = $alter . $v;
		}
		if (is_array($idxs)) {
			foreach($idxs as $idx => $idxdef) {

< 				$sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);



> 				$sql_idxs = $this->createIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);


				$sql = array_merge($sql, $sql_idxs);
			}
		}
		return $sql;
	}

	/**
	 * Change the definition of one column
	 *

< 	 * As some DBM's can't do that on there own, you need to supply the complete defintion of the new table,
< 	 * to allow, recreating the table and copying the content over to the new table



> 	 * As some DBMs can't do that on their own, you need to supply the complete definition of the new table,
> 	 * to allow recreating the table and copying the content over to the new table


	 * @param string $tabname table-name
	 * @param string $flds column-name and type for the changed column

< 	 * @param string $tableflds='' complete defintion of the new table, eg. for postgres, default ''
< 	 * @param array/string $tableoptions='' options for the new table see CreateTableSQL, default ''



> 	 * @param string $tableflds='' complete definition of the new table, eg. for postgres, default ''
> 	 * @param array|string $tableoptions='' options for the new table see createTableSQL, default ''


	 * @return array with SQL strings
	 */

< 	function AlterColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')



> 	function alterColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')


	{

< 		$tabname = $this->TableName ($tabname);



> 		$tabname = $this->tableName($tabname);


		$sql = array();

< 		list($lines,$pkey,$idxs) = $this->_GenFields($flds);



> 		list($lines,$pkey,$idxs) = $this->_genFields($flds);


		// genfields can return FALSE at times
		if ($lines == null) $lines = array();
		$alter = 'ALTER TABLE ' . $tabname . $this->alterCol . ' ';
		foreach($lines as $v) {
			$sql[] = $alter . $v;
		}
		if (is_array($idxs)) {
			foreach($idxs as $idx => $idxdef) {

< 				$sql_idxs = $this->CreateIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);



> 				$sql_idxs = $this->createIndexSql($idx, $tabname, $idxdef['cols'], $idxdef['opts']);


				$sql = array_merge($sql, $sql_idxs);
			}

		}
		return $sql;
	}

	/**
	 * Rename one column
	 *

< 	 * Some DBM's can only do this together with changeing the type of the column (even if that stays the same, eg. mysql)



> 	 * Some DBMs can only do this together with changeing the type of the column (even if that stays the same, eg. mysql)


	 * @param string $tabname table-name
	 * @param string $oldcolumn column-name to be renamed
	 * @param string $newcolumn new column-name

< 	 * @param string $flds='' complete column-defintion-string like for AddColumnSQL, only used by mysql atm., default=''



> 	 * @param string $flds='' complete column-definition-string like for addColumnSQL, only used by mysql atm., default=''


	 * @return array with SQL strings
	 */

< 	function RenameColumnSQL($tabname,$oldcolumn,$newcolumn,$flds='')



> 	function renameColumnSQL($tabname,$oldcolumn,$newcolumn,$flds='')


	{

< 		$tabname = $this->TableName ($tabname);



> 		$tabname = $this->tableName($tabname);


		if ($flds) {

< 			list($lines,$pkey,$idxs) = $this->_GenFields($flds);



> 			list($lines,$pkey,$idxs) = $this->_genFields($flds);


			// genfields can return FALSE at times
			if ($lines == null) $lines = array();
			$first  = current($lines);
			list(,$column_def) = preg_split("/[\t ]+/",$first,2);
		}

< 		return array(sprintf($this->renameColumn,$tabname,$this->NameQuote($oldcolumn),$this->NameQuote($newcolumn),$column_def));



> 		return array(sprintf($this->renameColumn,$tabname,$this->nameQuote($oldcolumn),$this->nameQuote($newcolumn),$column_def));


	}

	/**
	 * Drop one column
	 *

< 	 * Some DBM's can't do that on there own, you need to supply the complete defintion of the new table,



> 	 * Some DBM's can't do that on their own, you need to supply the complete definition of the new table,


	 * to allow, recreating the table and copying the content over to the new table
	 * @param string $tabname table-name
	 * @param string $flds column-name and type for the changed column

< 	 * @param string $tableflds='' complete defintion of the new table, eg. for postgres, default ''
< 	 * @param array/string $tableoptions='' options for the new table see CreateTableSQL, default ''



> 	 * @param string $tableflds='' complete definition of the new table, eg. for postgres, default ''
> 	 * @param array|string $tableoptions='' options for the new table see createTableSQL, default ''


	 * @return array with SQL strings
	 */

< 	function DropColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')



> 	function dropColumnSQL($tabname, $flds, $tableflds='',$tableoptions='')


	{

< 		$tabname = $this->TableName ($tabname);



> 		$tabname = $this->tableName($tabname);


		if (!is_array($flds)) $flds = explode(',',$flds);
		$sql = array();
		$alter = 'ALTER TABLE ' . $tabname . $this->dropCol . ' ';
		foreach($flds as $v) {

< 			$sql[] = $alter . $this->NameQuote($v);



> 			$sql[] = $alter . $this->nameQuote($v);


		}
		return $sql;
	}


< 	function DropTableSQL($tabname)



> 	function dropTableSQL($tabname)


	{

< 		return array (sprintf($this->dropTable, $this->TableName($tabname)));



> 		return array (sprintf($this->dropTable, $this->tableName($tabname)));


	}


< 	function RenameTableSQL($tabname,$newname)



> 	function renameTableSQL($tabname,$newname)


	{

< 		return array (sprintf($this->renameTable, $this->TableName($tabname),$this->TableName($newname)));



> 		return array (sprintf($this->renameTable, $this->tableName($tabname),$this->tableName($newname)));


	}

	/**
	 Generate the SQL to create table. Returns an array of sql strings.
	*/

< 	function CreateTableSQL($tabname, $flds, $tableoptions=array())



> 	function createTableSQL($tabname, $flds, $tableoptions=array())


	{

< 		list($lines,$pkey,$idxs) = $this->_GenFields($flds, true);



> 		list($lines,$pkey,$idxs) = $this->_genFields($flds, true);


		// genfields can return FALSE at times
		if ($lines == null) $lines = array();


< 		$taboptions = $this->_Options($tableoptions);
< 		$tabname = $this->TableName ($tabname);
< 		$sql = $this->_TableSQL($tabname,$lines,$pkey,$taboptions);



> 		$taboptions = $this->_options($tableoptions);
> 		$tabname = $this->tableName($tabname);
> 		$sql = $this->_tableSQL($tabname,$lines,$pkey,$taboptions);



		// ggiunta - 2006/10/12 - KLUDGE:
        // if we are on autoincrement, and table options includes REPLACE, the
        // autoincrement sequence has already been dropped on table creation sql, so
        // we avoid passing REPLACE to trigger creation code. This prevents
        // creating sql that double-drops the sequence
        if ($this->autoIncrement && isset($taboptions['REPLACE']))
        	unset($taboptions['REPLACE']);

< 		$tsql = $this->_Triggers($tabname,$taboptions);



> 		$tsql = $this->_triggers($tabname,$taboptions);


		foreach($tsql as $s) $sql[] = $s;

		if (is_array($idxs)) {
			foreach($idxs as $idx => $idxdef) {

< 				$sql_idxs = $this->CreateIndexSql($idx, $tabname,  $idxdef['cols'], $idxdef['opts']);



> 				$sql_idxs = $this->createIndexSql($idx, $tabname,  $idxdef['cols'], $idxdef['opts']);


				$sql = array_merge($sql, $sql_idxs);
			}
		}

		return $sql;
	}




< 	function _GenFields($flds,$widespacing=false)



> 	function _genFields($flds,$widespacing=false)


	{
		if (is_string($flds)) {
			$padding = '     ';
			$txt = $flds.$padding;
			$flds = array();

< 			$flds0 = Lens_ParseArgs($txt,',');



> 			$flds0 = lens_ParseArgs($txt,',');


			$hasparam = false;
			foreach($flds0 as $f0) {
				$f1 = array();
				foreach($f0 as $token) {
					switch (strtoupper($token)) {
					case 'INDEX':
						$f1['INDEX'] = '';
						// fall through intentionally
					case 'CONSTRAINT':
					case 'DEFAULT':
						$hasparam = $token;
						break;
					default:
						if ($hasparam) $f1[$hasparam] = $token;
						else $f1[] = $token;
						$hasparam = false;
						break;
					}
				}
				// 'index' token without a name means single column index: name it after column
				if (array_key_exists('INDEX', $f1) && $f1['INDEX'] == '') {
					$f1['INDEX'] = isset($f0['NAME']) ? $f0['NAME'] : $f0[0];
					// check if column name used to create an index name was quoted
					if (($f1['INDEX'][0] == '"' || $f1['INDEX'][0] == "'" || $f1['INDEX'][0] == "`") &&
						($f1['INDEX'][0] == substr($f1['INDEX'], -1))) {
						$f1['INDEX'] = $f1['INDEX'][0].'idx_'.substr($f1['INDEX'], 1, -1).$f1['INDEX'][0];
					}
					else
						$f1['INDEX'] = 'idx_'.$f1['INDEX'];
				}
				// reset it, so we don't get next field 1st token as INDEX...
				$hasparam = false;

				$flds[] = $f1;

			}
		}
		$this->autoIncrement = false;
		$lines = array();
		$pkey = array();
		$idxs = array();
		foreach($flds as $fld) {

< 			$fld = _array_change_key_case($fld);
< 



> 			if (is_array($fld))
> 				$fld = array_change_key_case($fld,CASE_UPPER);


			$fname = false;
			$fdefault = false;
			$fautoinc = false;
			$ftype = false;
			$fsize = false;
			$fprec = false;
			$fprimary = false;
			$fnoquote = false;
			$fdefts = false;
			$fdefdate = false;
			$fconstraint = false;
			$fnotnull = false;
			$funsigned = false;
			$findex = '';
			$funiqueindex = false;

> 			$fOptions	  = array();



			//-----------------
			// Parse attributes
			foreach($fld as $attr => $v) {

< 				if ($attr == 2 && is_numeric($v)) $attr = 'SIZE';
< 				else if (is_numeric($attr) && $attr > 1 && !is_numeric($v)) $attr = strtoupper($v);



> 				if ($attr == 2 && is_numeric($v))
> 					$attr = 'SIZE';
> 				elseif ($attr == 2 && strtoupper($ftype) == 'ENUM')
> 					$attr = 'ENUM';
> 				else if (is_numeric($attr) && $attr > 1 && !is_numeric($v))
> 					$attr = strtoupper($v);



				switch($attr) {
				case '0':
				case 'NAME': 	$fname = $v; break;
				case '1':

< 				case 'TYPE': 	$ty = $v; $ftype = $this->ActualType(strtoupper($v)); break;



> 				case 'TYPE':
> 
> 					$ty = $v;
> 					$ftype = $this->actualType(strtoupper($v));
> 					break;



				case 'SIZE':

< 								$dotat = strpos($v,'.'); if ($dotat === false) $dotat = strpos($v,',');
< 								if ($dotat === false) $fsize = $v;



> 					$dotat = strpos($v,'.');
> 					if ($dotat === false)
> 						$dotat = strpos($v,',');
> 					if ($dotat === false)
> 						$fsize = $v;


								else {

> 


									$fsize = substr($v,0,$dotat);
									$fprec = substr($v,$dotat+1);

> 


								}
								break;
				case 'UNSIGNED': $funsigned = true; break;
				case 'AUTOINCREMENT':
				case 'AUTO':	$fautoinc = true; $fnotnull = true; break;
				case 'KEY':
                // a primary key col can be non unique in itself (if key spans many cols...)
				case 'PRIMARY':	$fprimary = $v; $fnotnull = true; /*$funiqueindex = true;*/ break;
				case 'DEF':
				case 'DEFAULT': $fdefault = $v; break;
				case 'NOTNULL': $fnotnull = $v; break;
				case 'NOQUOTE': $fnoquote = $v; break;
				case 'DEFDATE': $fdefdate = $v; break;
				case 'DEFTIMESTAMP': $fdefts = $v; break;
				case 'CONSTRAINT': $fconstraint = $v; break;
				// let INDEX keyword create a 'very standard' index on column
				case 'INDEX': $findex = $v; break;
				case 'UNIQUE': $funiqueindex = true; break;

> 				case 'ENUM':
				} //switch
> 					$fOptions['ENUM'] = $v; break;


			} // foreach $fld

			//--------------------
			// VALIDATE FIELD INFO
			if (!strlen($fname)) {
				if ($this->debug) ADOConnection::outp("Undefined NAME");
				return false;
			}

			$fid = strtoupper(preg_replace('/^`(.+)`$/', '$1', $fname));

< 			$fname = $this->NameQuote($fname);



> 			$fname = $this->nameQuote($fname);



			if (!strlen($ftype)) {
				if ($this->debug) ADOConnection::outp("Undefined TYPE for field '$fname'");
				return false;
			} else {
				$ftype = strtoupper($ftype);
			}


< 			$ftype = $this->_GetSize($ftype, $ty, $fsize, $fprec);



> 			$ftype = $this->_getSize($ftype, $ty, $fsize, $fprec, $fOptions);




< 			if ($ty == 'X' || $ty == 'X2' || $ty == 'B') $fnotnull = false; // some blob types do not accept nulls



> 			if (($ty == 'X' || $ty == 'X2' || $ty == 'XL' || $ty == 'B') && !$this->blobAllowsNotNull)
> 				/*
> 				* some blob types do not accept nulls, so we override the
> 				* previously defined value
> 				*/
> 				$fnotnull = false;




< 			if ($fprimary) $pkey[] = $fname;



> 			if ($fprimary)
> 				$pkey[] = $fname;




< 			// some databases do not allow blobs to have defaults
< 			if ($ty == 'X') $fdefault = false;



> 			if (($ty == 'X' || $ty == 'X2' || $ty == 'XL' || $ty == 'B') && !$this->blobAllowsDefaultValue)
> 				/*
> 				* some databases do not allow blobs to have defaults, so we
> 				* override the previously defined value
> 				*/
> 				$fdefault = false;



			// build list of indexes
			if ($findex != '') {
				if (array_key_exists($findex, $idxs)) {
					$idxs[$findex]['cols'][] = ($fname);
					if (in_array('UNIQUE', $idxs[$findex]['opts']) != $funiqueindex) {
						if ($this->debug) ADOConnection::outp("Index $findex defined once UNIQUE and once not");
					}
					if ($funiqueindex && !in_array('UNIQUE', $idxs[$findex]['opts']))
						$idxs[$findex]['opts'][] = 'UNIQUE';
				}
				else
				{
					$idxs[$findex] = array();
					$idxs[$findex]['cols'] = array($fname);
					if ($funiqueindex)
						$idxs[$findex]['opts'] = array('UNIQUE');
					else
						$idxs[$findex]['opts'] = array();
				}
			}

			//--------------------
			// CONSTRUCT FIELD SQL
			if ($fdefts) {
				if (substr($this->connection->databaseType,0,5) == 'mysql') {
					$ftype = 'TIMESTAMP';
				} else {
					$fdefault = $this->connection->sysTimeStamp;
				}
			} else if ($fdefdate) {
				if (substr($this->connection->databaseType,0,5) == 'mysql') {
					$ftype = 'TIMESTAMP';
				} else {
					$fdefault = $this->connection->sysDate;
				}
			} else if ($fdefault !== false && !$fnoquote) {
				if ($ty == 'C' or $ty == 'X' or
					( substr($fdefault,0,1) != "'" && !is_numeric($fdefault))) {

					if (($ty == 'D' || $ty == 'T') && strtolower($fdefault) != 'null') {
						// convert default date into database-aware code
						if ($ty == 'T')
						{

< 							$fdefault = $this->connection->DBTimeStamp($fdefault);



> 							$fdefault = $this->connection->dbTimeStamp($fdefault);


						}
						else
						{

< 							$fdefault = $this->connection->DBDate($fdefault);



> 							$fdefault = $this->connection->dbDate($fdefault);


						}
					}
					else
					if (strlen($fdefault) != 1 && substr($fdefault,0,1) == ' ' && substr($fdefault,strlen($fdefault)-1) == ' ')
						$fdefault = trim($fdefault);
					else if (strtolower($fdefault) != 'null')
						$fdefault = $this->connection->qstr($fdefault);
				}
			}

< 			$suffix = $this->_CreateSuffix($fname,$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned);



> 			$suffix = $this->_createSuffix($fname,$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned);



			// add index creation
			if ($widespacing) $fname = str_pad($fname,24);

			 // check for field names appearing twice
            if (array_key_exists($fid, $lines)) {
            	 ADOConnection::outp("Field '$fname' defined twice");
            }

			$lines[$fid] = $fname.' '.$ftype.$suffix;

			if ($fautoinc) $this->autoIncrement = true;
		} // foreach $flds

		return array($lines,$pkey,$idxs);
	}

	/**
		 GENERATE THE SIZE PART OF THE DATATYPE
			$ftype is the actual type
			$ty is the type defined originally in the DDL
	*/

< 	function _GetSize($ftype, $ty, $fsize, $fprec)



> 	function _getSize($ftype, $ty, $fsize, $fprec, $options=false)


	{
		if (strlen($fsize) && $ty != 'X' && $ty != 'B' && strpos($ftype,'(') === false) {
			$ftype .= "(".$fsize;
			if (strlen($fprec)) $ftype .= ",".$fprec;
			$ftype .= ')';
		}

> 
		return $ftype;
> 		/*
	}
> 		* Handle additional options

> 		*/

> 		if (is_array($options))
	// return string must begin with space
> 		{
	function _CreateSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)
> 			foreach($options as $type=>$value)
	{
> 			{
		$suffix = '';
> 				switch ($type)
		if (strlen($fdefault)) $suffix .= " DEFAULT $fdefault";
> 				{
		if ($fnotnull) $suffix .= ' NOT NULL';
> 					case 'ENUM':
		if ($fconstraint) $suffix .= ' '.$fconstraint;
> 					$ftype .= '(' . $value . ')';
		return $suffix;
> 					break;
	}
> 

> 					default:
	function _IndexSQL($idxname, $tabname, $flds, $idxoptions)
> 				}
	{
> 			}
		$sql = array();
> 		}

> 



< 	function _CreateSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)



> 	function _createSuffix($fname,&$ftype,$fnotnull,$fdefault,$fautoinc,$fconstraint,$funsigned)



< 	function _IndexSQL($idxname, $tabname, $flds, $idxoptions)



> 	function _indexSQL($idxname, $tabname, $flds, $idxoptions)


			if ( isset($idxoptions['DROP']) )
				return $sql;
		}

		if ( empty ($flds) ) {
			return $sql;
		}

		$unique = isset($idxoptions['UNIQUE']) ? ' UNIQUE' : '';

		$s = 'CREATE' . $unique . ' INDEX ' . $idxname . ' ON ' . $tabname . ' ';

		if ( isset($idxoptions[$this->upperName]) )
			$s .= $idxoptions[$this->upperName];

		if ( is_array($flds) )
			$flds = implode(', ',$flds);
		$s .= '(' . $flds . ')';
		$sql[] = $s;

		return $sql;
	}


< 	function _DropAutoIncrement($tabname)



> 	function _dropAutoIncrement($tabname)


	{
		return false;
	}


< 	function _TableSQL($tabname,$lines,$pkey,$tableoptions)



> 	function _tableSQL($tabname,$lines,$pkey,$tableoptions)


	{
		$sql = array();

		if (isset($tableoptions['REPLACE']) || isset ($tableoptions['DROP'])) {
			$sql[] = sprintf($this->dropTable,$tabname);
			if ($this->autoIncrement) {

< 				$sInc = $this->_DropAutoIncrement($tabname);



> 				$sInc = $this->_dropAutoIncrement($tabname);


				if ($sInc) $sql[] = $sInc;
			}
			if ( isset ($tableoptions['DROP']) ) {
				return $sql;
			}
		}

> 


		$s = "CREATE TABLE $tabname (\n";
		$s .= implode(",\n", $lines);
		if (sizeof($pkey)>0) {
			$s .= ",\n                 PRIMARY KEY (";
			$s .= implode(", ",$pkey).")";
		}
		if (isset($tableoptions['CONSTRAINTS']))
			$s .= "\n".$tableoptions['CONSTRAINTS'];

		if (isset($tableoptions[$this->upperName.'_CONSTRAINTS']))
			$s .= "\n".$tableoptions[$this->upperName.'_CONSTRAINTS'];

		$s .= "\n)";
		if (isset($tableoptions[$this->upperName])) $s .= $tableoptions[$this->upperName];
		$sql[] = $s;

		return $sql;
	}

	/**
		GENERATE TRIGGERS IF NEEDED
		used when table has auto-incrementing field that is emulated using triggers
	*/

< 	function _Triggers($tabname,$taboptions)



> 	function _triggers($tabname,$taboptions)


	{
		return array();
	}

	/**
		Sanitize options, so that array elements with no keys are promoted to keys
	*/

< 	function _Options($opts)



> 	function _options($opts)


	{
		if (!is_array($opts)) return array();
		$newopts = array();
		foreach($opts as $k => $v) {
			if (is_numeric($k)) $newopts[strtoupper($v)] = $v;
			else $newopts[strtoupper($k)] = $v;
		}
		return $newopts;
	}


	function _getSizePrec($size)
	{
		$fsize = false;
		$fprec = false;
		$dotat = strpos($size,'.');
		if ($dotat === false) $dotat = strpos($size,',');
		if ($dotat === false) $fsize = $size;
		else {
			$fsize = substr($size,0,$dotat);
			$fprec = substr($size,$dotat+1);
		}
		return array($fsize, $fprec);
	}

	/**
	"Florian Buzin [ easywe ]" <florian.buzin#easywe.de>

	This function changes/adds new fields to your table. You don't
	have to know if the col is new or not. It will check on its own.
	*/

< 	function ChangeTableSQL($tablename, $flds, $tableoptions = false, $dropOldFlds=false)



> 	function changeTableSQL($tablename, $flds, $tableoptions = false, $dropOldFlds=false)


	{
	global $ADODB_FETCH_MODE;

		$save = $ADODB_FETCH_MODE;
		$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;

< 		if ($this->connection->fetchMode !== false) $savem = $this->connection->SetFetchMode(false);



> 		if ($this->connection->fetchMode !== false) $savem = $this->connection->setFetchMode(false);



		// check table exists
		$save_handler = $this->connection->raiseErrorFn;
		$this->connection->raiseErrorFn = '';

< 		$cols = $this->MetaColumns($tablename);



> 		$cols = $this->metaColumns($tablename);


		$this->connection->raiseErrorFn = $save_handler;


< 		if (isset($savem)) $this->connection->SetFetchMode($savem);



> 		if (isset($savem)) $this->connection->setFetchMode($savem);


		$ADODB_FETCH_MODE = $save;

		if ( empty($cols)) {

< 			return $this->CreateTableSQL($tablename, $flds, $tableoptions);



> 			return $this->createTableSQL($tablename, $flds, $tableoptions);


		}

		if (is_array($flds)) {
		// Cycle through the update fields, comparing
		// existing fields to fields to update.
		// if the Metatype and size is exactly the
		// same, ignore - by Mark Newham
			$holdflds = array();
			foreach($flds as $k=>$v) {
				if ( isset($cols[$k]) && is_object($cols[$k]) ) {
					// If already not allowing nulls, then don't change
					$obj = $cols[$k];
					if (isset($obj->not_null) && $obj->not_null)
						$v = str_replace('NOT NULL','',$v);
					if (isset($obj->auto_increment) && $obj->auto_increment && empty($v['AUTOINCREMENT']))
					    $v = str_replace('AUTOINCREMENT','',$v);

					$c = $cols[$k];
					$ml = $c->max_length;

< 					$mt = $this->MetaType($c->type,$ml);



> 					$mt = $this->metaType($c->type,$ml);



					if (isset($c->scale)) $sc = $c->scale;
					else $sc = 99; // always force change if scale not known.

					if ($sc == -1) $sc = false;
					list($fsize, $fprec) = $this->_getSizePrec($v['SIZE']);

					if ($ml == -1) $ml = '';
					if ($mt == 'X') $ml = $v['SIZE'];
					if (($mt != $v['TYPE']) || ($ml != $fsize || $sc != $fprec) || (isset($v['AUTOINCREMENT']) && $v['AUTOINCREMENT'] != $obj->auto_increment)) {
						$holdflds[$k] = $v;
					}
				} else {
					$holdflds[$k] = $v;
				}
			}
			$flds = $holdflds;
		}


		// already exists, alter table instead

< 		list($lines,$pkey,$idxs) = $this->_GenFields($flds);



> 		list($lines,$pkey,$idxs) = $this->_genFields($flds);


		// genfields can return FALSE at times
		if ($lines == null) $lines = array();

< 		$alter = 'ALTER TABLE ' . $this->TableName($tablename);



> 		$alter = 'ALTER TABLE ' . $this->tableName($tablename);


		$sql = array();

		foreach ( $lines as $id => $v ) {
			if ( isset($cols[$id]) && is_object($cols[$id]) ) {


< 				$flds = Lens_ParseArgs($v,',');



> 				$flds = lens_ParseArgs($v,',');



				//  We are trying to change the size of the field, if not allowed, simply ignore the request.
				// $flds[1] holds the type, $flds[2] holds the size -postnuke addition
				if ($flds && in_array(strtoupper(substr($flds[0][1],0,4)),$this->invalidResizeTypes4)
				 && (isset($flds[0][2]) && is_numeric($flds[0][2]))) {
					if ($this->debug) ADOConnection::outp(sprintf("<h3>%s cannot be changed to %s currently</h3>", $flds[0][0], $flds[0][1]));
					#echo "<h3>$this->alterCol cannot be changed to $flds currently</h3>";
					continue;
	 			}
				$sql[] = $alter . $this->alterCol . ' ' . $v;
			} else {
				$sql[] = $alter . $this->addCol . ' ' . $v;
			}
		}

		if ($dropOldFlds) {
			foreach ( $cols as $id => $v )
			    if ( !isset($lines[$id]) )
					$sql[] = $alter . $this->dropCol . ' ' . $v->name;
		}
		return $sql;
	}
} // class