4D v16.3

Somme

Accueil

 
4D v16.3
Somme

Somme 


 

Somme ( séries {; cheminAttribut} ) -> Résultat 
Paramètre Type   Description
séries  Champ, Tableau in Valeurs dont vous souhaitez calculer la somme
cheminAttribut  Texte in Chemin d'attribut duquel calculer la somme
Résultat  Réel in Somme de séries

Somme retourne la somme (c'est-à-dire le total de toutes les valeurs) de séries. Si séries est un champ indexé, l'index est utilisé pour le calcul.

Vous pouvez passer dans séries un tableau (à une ou deux dimensions). Dans ce cas, le tableau doit être de type Entier, Entier long ou Réel.

La commande accepte un paramètre optionnel de type texte, cheminAttribut, que vous pouvez utiliser si séries est un champ de type Objet. Il vous permet de définir le chemin de l'attribut dont le contenu doit être utilisé pour le calcul de la somme des valeurs. Utilisez la notation à points standard pour définir le chemin dans l'objet jusqu'à l'attribut, par exemple "Clients.enfants.age". Attention, gardez à l'esprit que les noms d'attributs d'objets tiennent compte de la casse des caractères.
Seules les valeurs numériques des attributs sont utilisées pour le calcul. Si l'attribut contient des valeurs non numériques, elles sont ignorées.

Si la commande est correctement exécutée, la variable système OK prend la valeur 1. Si elle est interrompue (par exemple si l'utilisateur clique sur le bouton Arrêt dans le thermomètre de progression), la variable OK prend la valeur 0.

L'exemple ci-dessous est la méthode objet d'une variable, vTotal, placée dans un formulaire. La méthode assigne à la variable la somme de tous les salaires :

 vTotal:=Somme([Employés]Salaire)

La méthode suivante est appelée pour imprimer les enregistrements de la sélection courante et activer le traitement des ruptures :

 TOUT SELECTIONNER([Employés])
 TRIER([Employés];[Employés]Nom;>)
 NIVEAUX DE RUPTURES(1)
 CUMULER SUR([Employés]Salaire)
 FORMULAIRE SORTIE([Employés];"FormImpression")
 IMPRIMER SELECTION([Employés])

Note : La valeur du paramètre de la commande NIVEAUX DE RUPTURES doit être égale au nombre de ruptures que contient l'état. Pour plus d'informations sur les ruptures, reportez-vous aux commandes du thème Impressions.

Cet exemple vous permet d’obtenir la somme de toutes les valeurs placées dans un tableau :

 TABLEAU REEL($TabNote;0)
 CHERCHER([Exams];[Exams]Exam_Date=!01/07/11!)
 SELECTION VERS TABLEAU([Exams]Exam_Note;$TabNote)
 vSomme:=Somme($TabNote)

Pour un exemple de calcul utilisant un attribut de champ objet, veuillez vous reporter à l'exemple 3 de la commande Moyenne.



Voir aussi  

CUMULER SUR
IMPRIMER SELECTION
Max
Min
Moyenne
NIVEAUX DE RUPTURES
Sous total
TRIER

 
PROPRIÉTÉS 

Produit : 4D
Thème : Fonctions statistiques
Numéro : 1
Nom intl. : Sum

Cette commande modifie la variable système OKCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

New
Modifié : 4D v11 SQL Release 3
Modifié : 4D v13
Modifié : 4D v16

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)