revDatabaseColumnNames

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
revDatabaseColumnNames(<recordSetOrConnectionId> [, <tableName>])
Synonymsrevdb_columnnames
Associationsdatabase library
Summary

Returns the list of database field names in a record set or a database table

Introduced1.1
Changes

The ability to obtain the list of fields for a table without obtaining a record set first was added in version 2.9

OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
recordSetOrConnectionId

The recordSetOrConnectionId is either the number returned by the revQueryDatabase when the record set was created or the number returned by the revOpenDatabase function when the connection was created.

tableName

The name of a table in the current database. A table name should be specified if the recordSetOrConnectionId parameter is a connection id.

Example
revDatabaseColumnNames(foundResults)
get revDatabaseColumnNames(field "Current Results")
get revDatabaseColumnNames(tConnectionId, "myTable")
Values
NameTypeDescription
return

The revDatabaseColumnNames function returns a list of databasefield names, separated by commas.

RelatedKeyword: string
Control Structure: function
Function: revDatabaseColumnCount, revDatabaseColumnNamed, revDatabaseColumnTypes, revDatabaseColumnIsNull
Library: Database library
Glossary: LiveCode custom library, database field, Standalone Application Settings, standalone application, record set, return, SQL query
Securitydisk, network
Description

Use the revDatabaseColumnNames function to find out what database fields are in the record set returned by a SQL query or what database fields are contained within a certain table.

There are two forms of the revDatabaseColumnNames function. It can either be used to return the list of column names in a record set, or as of version 2.9, the list of columns in a given table.

To get the list of columns in a record set use a form like this:

get revDatabaseColumnNames(tRecordSetId)

To get the list of columns in a given table, use a form like this:

get revDatabaseColumnNames(tConnectionId, "myTable")

If the operation is not successful, the revDatabaseColumnNames function returns an error message that begins with the string "revdberr".

Important: The revDatabaseColumnNames function is part of the Database library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure both the "Database" library checkbox and those of the database drivers you are using are checked.

Tagsdatabase