C16_FldDataChar
C16_FldDataChar(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aSbrNo, const vINT aFldNo, vCHAR* aFldBuf, const vINT aFormatFlags, const vINT aPostcomma, const vBOOL aWriteFlag) : vERROR
Feld übertragen und konvertieren
Details
- aInstHdl: Instanz-Handle
- aFileNo: Dateinummer
- aSbrNo: Teildatensatznummer
- aFldNo: Feldnummer
- aFldBuf: Zeiger auf Feldpuffer
- aFormatFlags: Formatierung
- aPostcomma: Nachkommastellen
- aWriteFlag: Feld schreiben (true), lesen (false)
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_ExcFldData() , C16_FldData() , C16_FldDataRaw() , C16_SetCharDefs()
Liest den Inhalt eines Feldes und konvertiert ihn in eine ASCII-Zeichenkette bzw. konvertiert eine ASCII-Zeichenkette in das entsprechende Datenformat und schreibt sie in das angegebene Feld. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Die Parameter (aFileNo), (aSbrNo) und (aFldBuf) identifizieren eindeutig das Feld, das ausgelesen bzw. geschrieben werden soll. Die Art der Formatierung wird in den Parametern (aFormatFlags) und (aPostcomma) angegeben. In (aFormatFlags) kann eine oder mehrere (logische OR-Verknüpfung) der nachfolgenden symbolischen Konstanten angegeben werden:
- _FmtNone: keine bestimmte Formatierung
- _FmtTSep: Tausendertrennung
- _FmtZeroSupr: Nullunterdruckung
- _FmtPlusSign: Positive Werte werden mit einem vorangestellten Plussymbol versehen
- _FmtDateLongYear: Jahr bei Datumsfeldern mit Jahrhundertangabe
- _FmtTimeSeconds: Bei Datentyp Zeit werden Sekunden berücksichtigt
- _FmtTimeHSeconds: Bei Datentyp Zeit werden Hundertstelsekunden berücksichtigt. Diese Option sollte sinnvollerweise mit _FmtTimeSeconds kombiniert werden.
Beim Datentyp Gleitkomma kann im Parameter (aPostcomma) die Anzahl der Nachkommastellen übergeben werden. Alle anderen Datentypen kann hier 0 angegeben werden. Der Parameter (aWriteFlag) gibt an, ob die in (aFldBuf) bereitgestellten Daten in den Puffer von (aFldNo) geschrieben werden (true) oder der Inhalt des Feldpuffers (aFldNo) nach (aFldBuf) kopiert wird (false).
Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ). Im Falle eines negativen Wertes ist ein Fehler aufgetreten und die Daten sind nicht übertragen worden.