Ansicht
Dokumentation

DB_CONVERT_FIELD_TO_HOST - Konvertiert ein Zahlenfeld in ein maschinenabhängiges Format

General Data in Customer Master   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dies ist der inverse Funktionsbaustein zu DB_CONVERT_FIELD_TO_NEUT. Der Funktionsbaustein konvertiert ein ABAP-Datenfeld, das zuvor durch den Funktionsbaustein DB_CONVERT_FIELD_TO_NEUT in ein neutrales, d.h. maschinenunabhängiges Format, konvertiert wurde, zurück in ein maschinenabhängiges Format, entsprechend der Felddarstellung des Applikationsservers, auf dem der Funktionsbaustein aufgerufen wird.

In einem Nicht-Unicode-System hat die Konvertierung nur Auswirkungen auf Felder mit den Zahlentypen FLTP, INT2 und INT4. In einem Unicode-System hingegen werden auch alle CHAR-artigen Datentypen (CHAR, CUKY, DATS, LANG, LCHR, NUMC, SSTRING, STRING, TIMS) auf den Applikationsservern in einem maschinenabhängigen Format repräsentiert, so daß der Funktionsbaustein auch bei diesen Typen aus einem neutralen Format wieder das maschinenabhängige Feldformat erzeugt. Bei allen anderen Datentypen kann der Funktionsbaustein zwar ebenso aufgerufen werden, er hat in diesem Fall jedoch keinen Effekt.

Die Konvertierung findet "in-place" statt, d.h. das als Parameter FIELD übergebene Feld ist zugleich Ein- als auch Ausgabefeld.

Parameter

TYPE

Der Parameter TYPE spezifiert den Typ des Feldes wie er in dem Laufzeitobjekt der zugehörigen Tabelle abgelegt ist. Das Laufzeitobjekt einer Tabelle kann z.B. durch den Sprachbefehl "IMPORT NAMETAB ..." gelesen werden. Die Feldeigenschaften werden hierbei in einer internern Tabelle mit der Struktur X031L zurückgeliefert, wobei die Komponente X031L-FIELDTYPE den codierten Typ des betreffenden Feldes enthält.

FIELD

Das zu konvertierende Feld wird dem Funktionsbaustein als Folge von Bytes (TYP X) übergeben, wobei das Eingabefeld mindestens die dem Typ TYPE entsprechende Größe haben muß.

Ausnahmen

WRONG_PARAM

Das übergebene Feld FIELD ist kleiner als für den spezifizierten Feldtyp TYPE erwartete wurde.

Beispiel

* The example program reads the neutral representation of the contents
* of a table's workarea from the database and converts it to the
* representation that is required by the application server's machine
* type. It is expected that the neutral format has been created by
* the use of the inverse function DB_CONVERT_HOST_TO_NEUT.

data:
  x030l_wa type x030l,
  x031l_tab type table of x031l with header line,
  bytes(N) type X,
field-symbols:
   type X.

* get runtime object of table

.
import nametab x030l x031l_tab id ''.
check sy-subrc = 0.

* get the neutral representation of the table's workarea, e.g. from
* the database
perform get_neutral_rep_of_table using bytes.

* loop over the table's fields and convert them into the correct
* machine representation.
loop at x031l_tab.
  assign bytes+x031l_tab-offset(*) to .
  call function 'DB_CONVERT_FIELD_TO_HOST'
       exporting
         type  = x031l_tab-fieldtype
         field =
       exceptions
         others = 1.
endloop.

Hinweise

Weiterführende Informationen

Parameter

FIELD
TYPE

Ausnahmen

WRONG_PARAM

Funktionsgruppe

SDBI_CONV

Fill RESBD Structure from EBP Component Structure   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3926 Date: 20240523 Time: 150223     sap01-206 ( 65 ms )