1.3.29 StpUpd – Updaten eines Datensatzes mit Bufferangabe
StpUpd( strBufName, nPath, strMask, strBuffer );
|
Argumente
|
strBufName
Name des Buffers.
Der BufferName ist einer Datenbankdatei zugeordnet.
| ||||||||||||
|
|
nPath
Pfad, über den der Satz gesucht wird.
| ||||||||||||
|
|
strMask
Angabe des Maskierungszeichens. Es wird nur die Länge 1 ausgewertet.
Beispiel Sei das Maskierungszeichen „#§$“, so wird # als Maskierungszeichen benutzt und die Teile des bestehenden Strings, die mit # gekennzeichnet sind, nicht ersetzt.
| ||||||||||||
|
|
strBuffer:
Wert, der angepasst werden soll. Ist der Buffer kürzer als die Satzlänge, wird der Rest mit Blanks aufgefüllt. Ist der Buffer länger, so werden die Werte nur bis zur Länge des anzupassenden Satzes übernommen und der Rest abgeschnitten.
| ||||||||||||
|
Rückgabewert:
|
StpRc
| ||||||||||||
|
Fehlerarten:
|
| ||||||||||||
|
Beschreibung
|
Die Funktion sucht zuerst den Datensatz.
Die Schlüssel müssen an der richtigen Position in strBuffer stehen.
Ist der Satz vorhanden, wird er mit den Werten in strBuffer überschrieben und in die Datenbank zurückgeschrieben.
Wurde der Satz nicht gefunden, wird er eingefügt.
Der Skripter kann den Returncode auswerten.
Ist die Protokollierung aktiv, werden die zu anzupassenden Sätze, bzw. die Fehler in die Logdatei geschrieben.
Hinweis: Felder, die mit Leerzeichen übergeben werden, werden formatgerecht mit Null versorgt (z.B. Datum 00000000). Werden aber vorhandene Sätze aktualisiert, so werden die übergebenen Leerzeichen unformatiert übernommen !
| ||||||||||||
|
Funktionsart
|
STPFunktion
| ||||||||||||
|
Beispiel
|
AssignString( strBuffer, „0010310110012 Schreibtisch#######“);
StpUpd( TSS, 1, „#“, strBuffer );
if(StpRc == 0 ) //Satz wurde aktualisiert
|