[Home] [Downloads] [Search] [Help/forum]

DatabaseColumnType

Script function

world.DatabaseColumnType

Read about scripting

Type

Method

Summary

Returns the type of data in an SQL column

Prototype

long DatabaseColumnType(BSTR DbName, long Column);

View list of data type meanings

Description

You can use this, after successfully doing a DatabaseStep, to find the type of data actually in each column of the current row.

Data types are:

Integer: 1
Float: 2
Text: 3
Blob: 4
Null: 5

This can be called after DatabaseStep to find whether a particular column is text, a number, or NULL (no data).

Columns start at 1 for the first column, up to the number returned by DatabaseColumns.


Available in MUSHclient version 4.40 onwards.



Lua example

t = DatabaseColumnType ("db", 2)  --> 3 (if the column is text)


Return value

A positive integer representing the data type of the specified column, as follows:

Integer: 1
Float: 2
Text: 3
Blob: 4
Null: 5

Otherwise, an error code:

-1 : Database id not found
-2 : Database not open
-4 : Do not have prepared statement
-5 : Do not have a valid row
-7 : Column number out of range


See Also ...

Topics

Database (SQLite)
Lua SQLite (database) interface
Scripting

Functions

(DatabaseChanges) Returns a count of the changes to the database by the most recent SQL statement
(DatabaseClose) Closes an SQLite database
(DatabaseColumnName) Find the name of a specified column returned by an SQL statement
(DatabaseColumnNames) Return a table of all the columns returned by an SQL statement
(DatabaseColumns) Find how many columns will be returned by an SQL statement
(DatabaseColumnText) Returns the contents of an SQL column, as text
(DatabaseColumnValue) Returns the contents of an SQL column, as text, float, integer, or null
(DatabaseColumnValues) Returns the contents of all the SQL columns after a step
(DatabaseError) Returns an English string describing the most recent SQL error
(DatabaseExec) Executes SQL code against an SQLite database
(DatabaseFinalize) Finalizes (wraps up) a previously-prepared SQL statement
(DatabaseGetField) Returns a single field from an SQL database
(DatabaseInfo) Returns information about a database
(DatabaseLastInsertRowid) Returns the most recently automatically allocated database key
(DatabaseList) Lists all databases
(DatabaseOpen) Opens an SQLite database
(DatabasePrepare) Prepares an SQL statement for execution
(DatabaseReset) Resets a previously-prepared SQL statement to the start
(DatabaseStep) Executes a previously-prepared SQL statement
(DatabaseTotalChanges) Returns a count of the total changes to the database

(Help topic: function=DatabaseColumnType)

Documentation contents page


Search ...

Enter a search string to find matching documentation.

Search for:   

Quick links: MUSHclient. MUSHclient help. Forum shortcuts. Posting templates. Lua modules. Lua documentation.

Information and images on this site are licensed under the Creative Commons Attribution 3.0 Australia License unless stated otherwise.

[Home]


Written by Nick Gammon - 5K   profile for Nick Gammon on Stack Exchange, a network of free, community-driven Q&A sites   Marriage equality

Comments to: Gammon Software support
[RH click to get RSS URL] Forum RSS feed ( https://gammon.com.au/rss/forum.xml )

[Best viewed with any browser - 2K]    [Hosted at FutureQuest]