Ansicht
Dokumentation

CL_ISH_ITAB - IS-H: Interne Tabelle

PERFORM Short Reference   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Die Klasse CL_ISH_ITAB ist die abstrakte Basisklasse für eine Kollektion, die auf einer internen Tabelle basiert.

Eine generelle Übersicht zu Kollektionen finden Sie in der Klassendokumentation zu CL_ISH_COLLECTION.

Den verschiedenen internen Tabellentypen entsprechend gibt es folgende Ausprägungen:

• Index-Tabellen
  Index-Tabellen werden durch die abstrakte Klasse CL_ISH_INDEXED_ITAB abgebildet.
  Entsprechend der Subtypen von internen Index-Tabellen gibt es folgende weitere Untergliederung:

• Sortierte Tabellen
  Diese werden durch die Klasse CL_ISH_SORTED_ITAB abgebildet.

• Standardtabellen
  Diese werden durch die Klasse CL_ISH_STANDARD_ITAB abgebildet.

• Hash-Tabellen
  Hash-Tabellen werden durch die Klasse CL_ISH_HASHED_ITAB abgebildet.

In der Klasse CL_ISH_ITAB sind jene Funktionalitäten definiert, die jeder interne Tabellentyp bietet.

Diese Funktionalitäten werden durch Methoden implementiert und können folgendermaßen kategorisiert werden:

• Auslesen von Informationen

• Mit der Methode ALLOWS_NULL_ENTRIES kann ermittelt werden, ob initiale Einträge erlaubt sind.

• Mit den Methoden AS_ITAB und AS_ITAB_REF lässt sich jedes CL_ISH_ITAB-Objekt als interne Tabelle darstellen.

• Mit der Methode CONTAINS kann ermittelt werden, ob die interne Tabelle einen bestimmten Wert beinhaltet.

• Mit der Methode OCCURENCES_OF kann ermittelt werden, wie oft ein bestimmter Wert in der internen Tabelle enthalten ist.

• Bearbeiten der Einträge

• Mit der Methode INSERT kann ein Eintrag in die interne Tabelle vorgenommen werden.
  An welcher Stelle der Eintrag eingefügt wird, bestimmt der zugrunde liegende interne Tabellentyp.

• Mit der Methode INSERT_ITAB können Einträge einer beliebigen internen Tabelle in die interne Tabelle übernommen werden.

• Mit der Methode REMOVE können Einträge eines bestimmten Wertes aus der internen Tabelle entfernt werden.

• Mit der Methode REPLACE kann das erste Vorkommnis eines bestimmten Wertes durch einen anderen Wert ersetzt werden.

Beziehungen

Die Klasse CL_ISH_ITAB erbt von der Klasse CL_ISH_COLLECTION.

Folgende Unterklassen existieren:

• CL_ISH_INDEXED_ITAB

• CL_ISH_HASHED_ITAB

Beispiel

Hinweise

Es ist erlaubt, weitere Ausprägungen von internen Tabellen (Unterklassen von CL_ISH_ITAB oder deren Ableitungen) anzulegen.

Es wird allerdings empfohlen, nur Unterklassen von bereits instanzierbaren Tabellenklassen anzulegen:

• CL_ISH_STANDARD_ITAB

• CL_ISH_STANDARD_OBJECT_ITAB

• CL_ISH_SORTED_ITAB

• CL_ISH_SORTED_OBJECT_ITAB

• CL_ISH_HASHED_ITAB

• CL_ISH_HASHED_OBJECT_ITAB

Wird eine Unterklasse angelegt, sollten folgende Punkte berücksichtigt werden:

• Die Instanzierung sollte nur über eine öffentliche statische Methode der neuen Unterklasse möglich sein (creation protected).

• Die Tabellenklassen können erst sinnvoll arbeiten nachdem die geschützte Methode INITIALIZE aufgerufen wurde.
  Dieser Methode muss eine Referenz auf die zu verwaltende interne Tabelle übergeben werden.
  Achtung: Diese Referenz muss während der gesamten Lebensdauer des Tabellenobjekts gültig sein.
  Am einfachsten und auch am sinnvollsten lässt sich dies erreichen, indem ein öffentliches Instanzattribut (in weiterer Folge GT_TABLE genannt) definiert wird und der Methode INITIALIZE eine Referenz auf diese interne Tabelle übergeben wird (get reference of gt_table into lr_table).

Weiterführende Informationen

PERFORM Short Reference   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5598 Date: 20240425 Time: 170632     sap01-206 ( 78 ms )