Sum

Home

4D v16.3

Sum


Sum ( Werte {; AttributPfad} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Werte	Feld, Array	Werte, deren Summe ermittelt werden soll
AttributPfad	Text	Pfad des Attributs, dessen Summe zurückgegeben werden soll
Funktionsergebnis	Zahl	Summe von Werte

Beschreibung

Die Funktion Sum gibt die Summe von Werte zurück. Ist Werte ein indiziertes Feld, wird der Index für die Berechnung verwendet.

Im Parameter Werte können Sie ein Array (ein- oder zweidimensional) übergeben. Das Array muss vom Typ Ganzzahl, Lange Ganzzahl oder Zahl sein.

Diese Funktion erlaubt den optionalen Parameter AttributPfad vom Typ Text, wenn Werte ein Feld oder eine Variable vom Typ Objekt ist. Hier können Sie den Pfad des Attributs zum Berechnen übergeben. Verwenden Sie die Standard Notation mit Punkt für Pfade zu eingebetteten Attributen, z.B. "company.address.number". Beachten Sie, dass Attributnamen vom Typ Objekt zwischen Groß- und Kleinschreibung unterscheiden.

Nur Attributwerte vom Typ Zahl werden berechnet. Gibt es im Attributpfad Werte, die nicht vom Typ Zahl sind, werden sie ignoriert.

Bei korrekt ausgeführter Funktion wird die Systemvariable OK auf 1 gesetzt. Wird sie unterbrochen, z.B. weil der Benutzer auf die Schaltfläche Stopp des Ablaufbalkens geklickt hat, wird die Variable OK auf 0 gesetzt.

Beispiel 1

Folgendes Beispiel zeigt eine Objektmethode für die Variable vTotal in einem Formular. Die Objektmethode weist vTotal die Summe aller Gehälter zu:

vTotal:=Sum([Employees]Salary)

Folgende Methode druckt die Datensätze in der Auswahl und aktiviert den Umbruch:

 ALL RECORDS([Employees])

 ORDER BY([Employees];[Employees]LastNm;>)

 BREAK LEVEL(1)

 ACCUMULATE([Employees]Salary)

 OUTPUT FORM([Employees];"PrintForm")

 PRINT SELECTION([Employees])

Hinweis: Der Parameter für den Befehl BREAK LEVEL sollte gleich sein mit der Anzahl der Umbrüche in Ihrem Bericht. Weitere Informationen dazu finden Sie im Kapitel Drucken.

Beispiel 2

Dieses Beispiel erhält die Summe aller Werte im Array:

 ARRAY REAL($ArrGrades;0)

 QUERY([Exams];[Exams]Exam_Date=!01/07/11!)

 SELECTION TO ARRAY([Exams]Exam_Grade;$ArrGrades)

 vSum:=Sum($ArrGrades)

Beispiel 3

Ein Beispiel zum Berechnen eines Attributs Objektfeld finden Sie im 3. Beispiel unter dem Befehl Average.

Siehe auch

ACCUMULATE
Average
BREAK LEVEL
Max
Min
ORDER BY
PRINT SELECTION
Subtotal