#9 - Add describeTable()

Author: technicalguru

src/TgDatabase/DAO.php

@@ -43,6 +43,22 @@ public function tableExists() {
 		return $this->database->tableExists($this->tableName);
 	}
 
+	/**
+	 * Describes the underlying table.
+	 * {
+     *   "Field":   "uid",
+     *   "Type":    "int(10) unsigned",
+     *   "Null":    "NO",
+     *   "Key":     "PRI",
+     *   "Default": null,
+     *   "Extra":   "auto_increment"
+     * }
+	 * @return array of columns (empty when error occured).
+	 */
+	public function describeTable() {
+		return $this->database->describeTable($this->tableName);
+	}
+
 	/** 
 	 * Get the object with given id.
 	 * @param int $uid - ID of object (row)

src/TgDatabase/Database.php

@@ -100,12 +100,33 @@ public function quoteName($s) {
 	 * @return string TRUE when table exists, FALSE otherwise.
 	 */
 	public function tableExists($tableName) {
-		$res = $this->query('SELECT * FROM '.$this->tableName);
+		$res = $this->query('SELECT * FROM '.$tableName);
 		$rc  = $res !== FALSE;
 		if ($res) $res->free();
 		return $rc;
 	}
 
+	/**
+	 * Describes a table.
+	 * {
+     *   "Field":   "uid",
+     *   "Type":    "int(10) unsigned",
+     *   "Null":    "NO",
+     *   "Key":     "PRI",
+     *   "Default": null,
+     *   "Extra":   "auto_increment"
+     * }
+	 * @param string $tableName - name of table to be described
+	 * @return array of columns (empty when error occured).
+	 */
+	public function describeTable($tableName) {
+		$rc = array();
+		foreach ($this->queryList('DESCRIBE '.$tableName) AS $field) {
+			$rc[$field->Field] = $field;
+		}
+		return $rc;
+	}
+
 	/**
 	 * Execute the given SQL.
 	 * <p>This can be any arbitrary SQL statement. The function will only replace the table prefix