FB_TeachingProcedure - RemoveLastSample (Method)

Overview

Type:	Method
Available as of:	V1.8.0.0

This chapter provides information on:

Task
Description
Interface
Diagnostic Messages

Task

Removes the last stored sample.

Description

With the method RemoveLastSample(...), the last stored sample is removed. If the selected set is already empty, the method removes the last sample from the previous set. In this case, the previous set becomes the selected set.

NOTE: The active set and the number of samples already stored in it can be read using the properties udiActiveSetIndex and udiNumberOfSamplesInActiveSet.

Access: PUBLIC

Interface

Output	Data type	Description
q_xError	BOOL	TRUE: An error occurred during last command. For more information refer also to q_etResult and q_sResultMsg.
q_etResult	ET_Result	Provides diagnostic and status information. If q_xError = FALSE, then q_etResult provides status information. If q_xError = TRUE, then q_etResult provides diagnostic/error information. The enumeration ET_Result contains the possible values of the POU operation results.
q_sResultMsg	STRING[80]	Event-triggered message that gives more detailed information on the diagnostic state.

Output

Data type

Description

q_xError

BOOL

TRUE: An error occurred during last command. For more information refer also to q_etResult and q_sResultMsg.

q_etResult

ET_Result

Provides diagnostic and status information.

If q_xError = FALSE, then q_etResult provides status information.

If q_xError = TRUE, then q_etResult provides diagnostic/error information.

The enumeration ET_Result contains the possible values of the POU operation results.

q_sResultMsg

STRING[80]

Event-triggered message that gives more detailed information on the diagnostic state.

Diagnostic Messages

q_xError	q_etResult	Enumeration value of q_etResult	Description
FALSE	Ok	0	Success.
FALSE	PreviousSetSelected	33	Samples across different sets must contain positions sorted in a monotone increasing or decreasing order along the X coordinate.
TRUE	NoSamplesToRemove	34	No samples available to remove.

NoSamplesToRemove

Enumeration name:	NoSolutionFound
Enumeration value:	34
Description:	No samples available to remove.

Issue	Cause	Solution
It is not possible to remove the last sample.	There are no samples stored inside the function block.	Do not call this method if there are no available samples to remove.

Ok

Enumeration name:	Ok
Enumeration value:	0
Description:	Success.

Status message: Removing the last stored sample was successful.

PreviousSetSelected

Enumeration name:	PreviousSetSelected
Enumeration value:	32
Description:	Not enough samples to evaluate a cartesian pose.

Since the active set is empty, the sample is removed from the previous set. The previous set is then selected as the active one.