National Instruments 320682C Musical Toy Instrument User Manual


 
Chapter 8 Utility Library
© National Instruments Corporation 8-61 LabWindows/CVI Standard Libraries
Under UNIX, if the arguments to RenameFile specify files on different file systems,
RenameFile copies the source to the target and then deletes the source file.
RetireExecutableHandle
int
status
=
RetireExecutableHandle
(int
executableHandle
);
Purpose
Informs the Utility Library that you no longer intend to use the handle acquired from
LaunchExecutableEx. When you call this function the Utility Library can reuse the
memory allocated to keep track of the state of the executable.
Under UNIX, if the process has terminated, the system removes the process from the list of
processes. This keeps the system from reaching the limit on the total number of processes under
execution by a single user which the system imposes.
Parameters
Input executableHandle
integer The executable handle acquired from
LaunchExecutableEx.
-1 = handle is invalid.
0 = success.
Return Value
status
integer Result of operation.
RoundRealToNearestInteger
long
n = RoundRealToNearestInteger
(double
inputRealNumber
);
Purpose
Rounds its floating-point argument and returns the result as a long integer. A value with a
fractional part of exactly 0.5 is rounded to the nearest even number. This function is encountered
in translations.
Parameter
Input
inputRealNumber
Double-precision.