• a5_finddupsgenie Function
• a5_get_recs_in_qry_local Function
• a5_paste_current_record Function
• a5_paste_from_clipboard Function
• a5_paste_new_record Function
• a5_put_rec_on_clipboard Function
• a5_rec_clip_has_data Function
• a5_records_undelete Function
• a5_remove_recs_genie Function
• a5_selected_records Function
• BOTTOM_PERCENT_RECORDS Function
• BOTTOM_RECORDS Function
• CHANGE_RECORD Method
• CURRENT_RECORD Function
• CURRENT_RECORD_NUMBER Function
• DBAVG Function
• DBCOUNT Function
• DBMAX Function
• DBMIN Function
• DBSUM Function
• DELETE_RECORD Method
• DELETED Function
• ENTER RECORD Method
• EVERY_RECORD_LIST Function
• FILTER_STRING Function
• form_qs_explicit Function
• IS_RECNO_IN Function
• LOOKUP Function
• LOOKUPC Function
• LOOKUPD Function
• LOOKUPL Function
• LOOKUPN Function
• MARKED Function
• page_records_get Function
• POP_STDDEV Function
• POP_VARIANCE Function
• RANDOM_PCT_RECORD_LIST Function
• RANDOM_PERCENT_RECORDS Function
• RANDOM_RECORD_LIST Function
• RANDOM_RECORDS Function
• RECORD_ADD Function
• RECORD_DELETE Function
• RECORD_UPDATE Function
• RUN_AVERAGE Function
• RUN_MAXIMUM Function
• RUN_MINIMUM Function
• RUN_STDDEV Function
• RUN_VARIANCE Function
• SAMPLE_RECORDS Function
• STDDEV Function
• TOP_PERCENT_RECORDS Function
• TOP_RECORDS Function
• TOP_RECORDS_LIST Function
• TOP_RECORDS_PCT_LIST Function
• VARIANCE Function

DBSUM Function

Syntax

Arguments

Lookup_TableCharacter

The full drive, path, name, and extension of the table. If you omit the drive, path, and extension, Alpha Anywhere searches the directory of the current table.

tagname

The name of an index.

Key_Value

An explicit value or the name of a field in the table containing a value.

Lookup_ExpressionCharacter

An expression based on numeric or exponent numeric field(s) in the Lookup_Table.

Returns

Sum_Of_ValuesNumeric

Returns the total sum of the specified fields in the table. Returns 0 if no records are found.

Description

Returns the sum of fields of matching records in a specified table.

Discussion

DBSUM() searches the specified Lookup_Table for one or more records with the specified Key_Value, and returns the sum of the values contained in Lookup_Expression. If no records with matching key values are found, DBSUM() returns a zero value.

Example

Assume that a customer order table (ORDER) contains the following records:

The following expression returns the sum of the values in the AMOUNT field for all the records in the ORDER table with a customer Id number of "C102":

? dbsum("ORDER.DBF", "CUST_ID", "C102", "AMOUNT")
= 1098.35

This example uses the Customer_ID index to find the sum of the discounts on items sold to customer ID "00000005".

? dbsum("invoice_header", "Customer_ID", "00000005", "Discount")
= 10

This example is based on the invoice_items table of the AlphaSports database.

dim pnum as C = "P001"
? dbsum("invoice_items", "Product_ID", pnum, "Quantity")
= 18

Example: Filtering Results

The Lookup_Expression can be used to filter the records. For example, the following Xbasic queries the AlphaSports product table to sum products with a retail greater than $10 for a particular vendor:

dim vnum as C = "V002"
? dbsum("product", "vendor", vnum, "if(retail > 10,Qty_In_Sto,0)")
= 2138

See Also

• Record Functions