• 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

RECORD_ADD Function

Syntax

Arguments

tablenameCharacter

The name of a table

dataCharacter

A CR-LF delimited list of the field values to add as a new record. The data can be presented in two different formats as Defined by the Style argument.

styleNumeric

Default = 1. An optional style selector that defines the format of the data parameter. Value can be 1 or 2.

When entering data in an auto-increment field, use Style 1 and leave the value of the field blank. E.g. "Fieldname1 = ".

See explanation below for more information.

Returns

Result_FlagLogical

.T. = the record was added. .F. = the record was not added.

Description

Adds a new record to a table. Data is CRLF delimited list. Style 1 - data is fieldname=fieldvalue pairs, Style 2 data is just fieldvalues in same order as fieldnames

Discussion

RECORD_ADD() adds a new record to Table_Name using the field values specified by Data_List.Note : The RECORD_ADD() function opens and closes the table. You should not use TABLE.OPEN() or TABLE.CLOSE().

Example

dim cs as C
cs = "00000010" + crlf() + "Layout" +  crlf() + "Report"
? cs = 00000010
Layout
Report
record_add("category", cs, 2)

Setting the Style

The Style selector defines the format of the data. There are two options available:

• Style = 1

  The default style used, data is listed using a CR-LF delimited list of <field_name> = <value> pairs. For example:

  Fieldname1 = Value1
  Fieldname2 = Value2
  FieldnameN = ValueN

• If data must be included for auto-increment fields, you must use Style 1. You can specify the auto-increment field with a blank value as follows:

  Fieldname1 =

• Style = 2

  Data only includes the values. For example:

  Value1
  Value2
  ValueN

See Also

• Record Functions