ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / HFSQL functions
  • Deleting records from a query
  • Deleting records from an HFSQL view
  • Deleting records from a transaction
  • Benefits compared to a loop for deleting records
  • Advantage compared to HCreation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
HDeleteAll (Function)
In french: HSupprimeTout
ODBCNot available with this kind of connection
Deletes all records from a data file, an HFSQL view or a query. The records are deleted logically and physically. They cannot be restored.
The following operations are performed:
  • the records are deleted: the records are not referenced in the index anymore. The data is not kept.
  • the indexes (corresponding to the keys of the records) are deleted from the index file.
  • the memos associated with the records are deleted from the memo file.
  • the automatic identifiers are re-initialized.
Caution: the integrity is not checked.
WINDEV, WINDEV Mobile and WEBDEV propose an automatic management of errors for the following types of errors: Duplicate error, integrity error, password error, modification conflict error and status error during modification conflict, lock error. For more details, see Assisted HFSQL error handling.
AndroidAndroid Widget Java This function is available for the data files or queries linked to an HFSQL connection (Classic or Client/Server).
Example
// Clear data file without re-creating it
HDeleteAll(Customer)
Syntax
<Result> = HDeleteAll(<Data file>)
<Result>: Boolean
  • True if the records have been deleted,
  • False if a problem occurred (locked record, record in transaction, ...). HErrorInfo is used to identify the error.
<Data file>: Character string
Name of HFSQL data file, HFSQL view or query used.
Remarks

Deleting records from a query

If the query was created by using the hModifyFile constant, HDeleteAll deletes the records from the source of the query.

Deleting records from an HFSQL view

HDeleteAll deletes the records from the view but it does not delete the records from the data file used for the view.

Deleting records from a transaction

HDeleteAll does not delete the records found in a transaction (canceled or validated).

Benefits compared to a loop for deleting records

To delete the records from a data file, you can also set a loop for deleting the records (HDelete). For example:
FOR EACH CustNum OF Orders
HDelete()
END
Using HDeleteAll has the following advantages:
  • the process is faster,
  • the size of empty data file is smaller.

Advantage compared to HCreation

To delete the records from a data file, you also have the ability to use HCreation.
Using HDeleteAll has the following advantages:
  • Deletion possible even if users are connected to the data file.
  • Automatic management of HFSQL errors.
Component: wd290hf.dll
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help