The tablex Command
command is used to manage table file format handler extensions. The command has the following subcommands:
tablex defined format
A boolean check whether a specific table file format is supported by an I/O handler. If the format is not yet known, an attempt is made to locate and auto-load the I/O module. For an equivalent command without auto-loading, see
tablex exists format
A boolean check whether a specific table file format is supported by an I/O handler. No attempt is made to auto-load a handler module if it is not already in memory. The name can be the primary name of the table file format, or any recognized alias. For an equivalent command with auto-loading, see
tablex get format attribute
Query the value of an attribute of the table file format handler. The list of supported attributes is described in the section on the
If the format is not yet known, an attempt is made to auto-load it.
tablex list ?pattern?
Return a list of all currently supported table formats, including those handled by built-in format handlers. If desired, the list can be filtered by a string pattern.
tablex load format ?objectfile?
tablex load all
Explicitly load a table file format handler module. If the module is already loaded, the current version is unloaded first. If no specific object file (a shared library on Unix/Linux, a DLL on Windows, a bundle file for MacOSX) is specified, the standard name of the module file is automatically generated from the data type name, and then the file searched in the directories in the data type handler module path. The module search path can be customized in the control variable
, the return value of the command is the slot in the table file format module table the module has been loaded into. This corresponds to the value of the
attribute which can be queried via
, the return value is a module reference.
The second form of the command scans the currently set table format extension search path and loads all accessible modules which are not yet in memory. Modules which are already active in the running application are not unloaded, and only a single instance of each I/O module, even if present under various alias names in the module directories, is loaded. This form of the command does not return a value.
-only method to get a reference of the module, which allows terser attribute retrieval commands and other operations.
Return a list of all supported subcommands of the
command in the current interpreter.
tablex set format ?attribute value?...
tablex set format dict
tx.attribute = value
tx[attribute] = value
Set one or more attributes of the table file format handler. Some attributes are read-only. They are still listed here because the tablex get command refers to this section. The following attributes are recognized:
The city part of the author contact address.
The country part of the author contact address, following the ISO3166 standard.
The state part of the author contact address. Empty if not applicable.
The street address part of the author contact address. Includes floor, house number, etc.
code or other applicable postal code of the author contact address.
The institution the author of the table extension definition works for.
registration ID of the affiliated institution. This is primarily useful for US government projects.
of the affiliated institution.
A list of alternative names that are recognized as alternative names for the table file format.
The author of the module, as free-form text.
with information on the author, or an empty string if unset.
A boolean flag indicating whether the format handler is built-in. This is a read-only attribute.
A category string to be used if the table extension is stored in a repository.
The character set the file format uses.
The base class
of this module.
A free-form comment.
The date of the last change of the module source code.
A digital object identifier for the module, if defined.
An email contact address of the author.
A list of the types of functions the module provides in its function table. Function types include
(auto-identify file format),
(read that format) and
(write that format).
A URL with information on the module, or an empty string if unset.
A list of keywords associated with the module.
The license class associated with this module. Setting the license to a standard type updates the associated
with a standard location.
with details about the module license.
This is a free-form string for a literature reference describing the meaning and/or algorithm behind the module.
type of the table file format, for example
The primary name of the table file format. Because the format may have been specified via an alias name, this may not be the same as he command parameter.
The full path name of the object file (shared library, DLL or bundle file) of the module. For built-in modules, this is an empty string.
code of the author of the module (see www.orcid.org).
A keyword/value dictionary of format-specific I/O attributes with their default values which are not represented as general table object attributes. Upon file output with a specific format, parameters from this dictionary which have not been explicitly configured in the parameters attribute of the table object to be written are added from the table I/O module instance to it. Dictionary keys already set as a custom table parameters entry are not overwritten.
The repository path for displaying hierarchical repository trees. This attribute is independent of any file system paths.
A contact phone number of the author.
Cross references of the module. This is a nested list of class
s and reference type tags.
For registered modules, the registration ID. Unregistered modules report zero.
The table file format handler table slot the module is loaded into. This attribute is read-only.
The source file of the module, if available.
A list of file name suffixes associated with this format. This is a read-only attribute.
A version string.. This is a string in a 1.2.3 (or shortened) style.
associated with this module version.
tablex unload ?format?...
Unload one or more table file format handler modules. It is an error to specify the name of a module which is not loaded. Built-in modules cannot be unloaded.
The return value is the number of unloaded modules.