AFIELDS( )-Funktion

  • Artikel

Übergibt Informationen über die Struktur der aktuellen Tabelle an ein Array und gibt die Anzahl der Felder in der Tabelle zurück.

AFIELDS(ArrayName [, nWorkArea | cTableAlias])

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt ein Array an, an das die Informationen über die Tabellenstruktur übergeben werden sollen. Ist das in AFIELDS( ) angegebene Array nicht vorhanden, wird es von Visual FoxPro automatisch erstellt. Ist das Array vorhanden, aber nicht groß genug, um alle Informationen aufnehmen zu können, passt Visual FoxPro die Größe des Arrays automatisch entsprechend an.

  • nWorkArea
    Gibt den Arbeitsbereich der Tabelle an, für die Strukturinformationen an ein Array übergeben werden.

  • cTableAlias
    Gibt den Alias der Tabelle an, für die Strukturinformationen an ein Array übergeben werden.

    Werden nWorkArea und cTableAlias nicht angegeben, beziehen sich die Strukturinformationen im Array auf eine Tabelle im aktuell ausgewählten Arbeitsbereich.

    In der folgenden Tabelle werden der Inhalt jeder Spalte in der ersten Zeile des Arrays und der Datentyp der in den einzelnen Spalten gespeicherten Informationen beschrieben. Werte für tabellenspezifische Eigenschaften in den Spalten 10 bis 16 werden nur in der ersten Zeile des Arrays angezeigt. Für jedes Feld in der Tabelle wird eine Zeile erstellt.

    Spaltennummer Feldinformation Datentyp
    1 Feldname Zeichen
    2 Feldtyp:C = CharacterD = DateL = LogicalM = MemoN = NumericF = FloatI = IntegerB = DoubleY = CurrencyT = DateTimeG = General Zeichen
    3 Feldbreite Numerisch
    4 Dezimalstellen Numerisch
    5 Nullwerte zulässig Logisch
    6 Codepageumsetzung unzulässig Logisch
    7 Feldgültigkeitsausdruck Zeichen
    8 Feldgültigkeitstext Zeichen
    9 Standardfeldwert Zeichen
    10 Tabellengültigkeitsausdruck Zeichen
    11 Tabellengültigkeitstext Zeichen
    12 Langer Tabellenname Zeichen
    13 Insert-Trigger-Ausdruck Zeichen
    14 Update-Trigger-Ausdruck Zeichen
    15 Delete-Trigger-Ausdruck Zeichen
    16 Tabellenkommentar Zeichen

Hinweise

AFIELDS( ) gibt die Anzahl der Felder in der Tabelle zurück. Das Array enthält 16 Spalten. Die Anzahl der Zeilen ist identisch mit der Zahl der Felder in der Tabelle.

Sie können den COPY STRUCTURE EXTENDED-Befehl verwenden, um gleichartige Informationen in einer Tabelle statt in einem Array unterzubringen.

Beispiel

Im folgenden Beispiel wird ein Array mit Namen gaMyArray erstellt, das Informationen zu den Feldern in der CUSTOMER-Tabelle enthält. Die Namen der Felder werden anschließend angezeigt.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE Customer     && Open customer table

gnFieldcount = AFIELDS(gaMyArray)  && Create array
CLEAR
FOR nCount = 1 TO gnFieldcount 
   ? gaMyArray(nCount,1)  && Display field names
ENDFOR

Siehe auch

ADEL( ) | ADIR( ) | AELEMENT( ) | AINS( ) | ALEN( ) | ALTER TABLE – SQL-Befehl | ASCAN( ) | ASORT( ) | ASUBSCRIPT( ) | COPY STRUCTURE EXTENDED | CREATE | CREATE TABLE | DIMENSION