Dieser Befehl liest eine Hollywood-Tabelle aus der durch id
angegebenen
Datei und gibt sie in table
zurück. Das Lesen beginnt an der aktuellen
Position des Dateicursors, die Sie mit dem Befehl Seek()
ändern können.
Ab Hollywood 9.0 werden die Daten mit dem Deserializer bearbeitet, der im
Tag Adapter
im optionalen Tabellenargument angegeben werden kann. Vor
Version 9.0 verwendete ReadTable()
immer den alten Deserializer von Hollywood,
der ein proprietäres, nicht von Menschen lesbares Format verwendet.
Die folgenden Tags werden derzeit im optionalen Tabellenargument erkannt:
Adapter:
-
Dieser Tabellen-Tag kann benutzt werden, um den Deserialisierer
anzugeben, der zum Importieren der Daten in eine Hollywood-Tabelle
verwendet werden soll. Dies kann der Name eines externen Deserialisierungs-Plugins
(z.B.
xmlparser
) oder einer der folgenden integrierten
Deserializer sein:
Default:
-
Verwenden Sie den standardmäßigen Deserializer von Hollywood. Dadurch werden
Daten aus dem JSON-Format in eine Hollywood-Tabelle deserialisiert. Beachten
Sie, dass der Name dieses Deserializers zwar behauptet, der Standardname zu
sein, dies jedoch nicht der Fall ist. Aus Kompatibilitätsgründen verwendet
ReadTable()
standardmäßig den Inbuilt
Deserializer (siehe unten). Wenn Sie
möchten, dass ReadTable()
den JSON-Deserializer verwendet, müssen Sie ihn
explizit anfordern, indem Sie Adapter
auf Default
setzen.
Inbuilt:
-
Verwendet Hollywoods integrierten alten Deserialisierer. Die einzigen Daten,
die dieser Deserialisierer akzeptiert, sind Daten, die von Hollywoods altem
integrierten Serialisierer während des WriteTable()-Aufrufs
geschrieben wurden. Beachten Sie, dass dies aus Kompatibilitätsgründen
immer noch der Standard-Deserialisierer ist. Es wird jedoch nicht mehr
empfohlen, da die Daten in einem proprietären, nicht von Menschen lesbaren
Format vorliegen. Die Verwendung von JSON ist eine viel bessere Wahl.
Wenn der Tag Adapter
nicht angegeben ist, wird er standardmäßig auf den
mit dem Befehl SetDefaultAdapter() gesetzt. Beachten Sie, dass diese Voreinstellung
aus Kompatibilitätsgründen nicht Default
, sondern Inbuilt
ist. Siehe oben
für eine Erklärung.
UserTags:
-
Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an
Serializer-Plugins übergeben werden sollen. Wenn Sie diesen Tag verwenden,
müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die
zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen.
Siehe Benutzer-Tags für Details. (V10.0)
Mode:
-
Dieser Tag kann verwendet werden, um den für die Operation zu verwendenden
Serialisierungsmodus festzulegen. Er verwendet standardmäßig den
Serialisierungsmodus, der mit SetSerializeMode() festgelegt wurde.
Siehe SetSerializeMode für Details. (V10.0)
Options:
-
Dieser Tag kann verwendet werden, um die für den Vorgang zu verwendenden
Serialisierungsoptionen festzulegen. Standardmäßig werden die
Serialisierungsoptionen verwendet, die mit SetSerializeOptions()
festgelegt wurden. Siehe SetSerializeOptions für Details. (V10.0)
SrcEncoding:
-
Dieser Tag kann verwendet werden, um die Zeichencodierung der Quelle
anzugeben. Dies ist standardmäßig die Standard-Zeichencodierung der
Zeichenkettenbibliothek, wie sie von SetDefaultEncoding() festgelegt
wird. Siehe SetDefaultEncoding für Details. (V10.0)
DstEncoding:
-
Dieser Tag kann verwendet werden, um die Zielzeichencodierung anzugeben.
Dies ist standardmäßig die Standard-Zeichencodierung der
Zeichenkettenbibliothek, wie sie von SetDefaultEncoding()
festgelegt wird. Siehe SetDefaultEncoding für Details. (V10.0)