Utility Class Reference

Other Utilities APIs. More...

Static Public Member Functions
static void	spin (long spinCount)
	Performs the spin operation as many times as indicated. More...
static native long	get_spin_per_microsecond ()
	Returns the number of spin operations to perform to wait 1 microsecond. More...
static native boolean	enable_heap_monitoring ()
	[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.enable. More...
static native void	disable_heap_monitoring ()
	[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.disable. More...
static native boolean	pause_heap_monitoring ()
	[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.pause. More...
static native boolean	resume_heap_monitoring ()
	[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.resume More...
static native boolean	take_heap_snapshot (String filename, boolean print_details)
	[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.take_heap_snapshot. More...

Detailed Description

Other Utilities APIs.

Member Function Documentation

spin()

static void spin ( long  spinCount )

static

Performs the spin operation as many times as indicated.

Spinning is the action of performing useless operations in a for loop in order to actively wait some time without yielding the CPU. Given that the resolution of sleep is in the order of ms, you can use this utility to wait times in the order of microseconds. To properly use this functionality, it is useful to measure previously the number of spin operations needed to wait the equivalent to microsecond (using the utility get_spin_per_microsecond) and then compute the corresponding spin count desired.

Parameters

spinCount

<<in>> Number of spin operations to perform.

References Utility.disable_heap_monitoring(), Utility.enable_heap_monitoring(), Utility.get_spin_per_microsecond(), Utility.pause_heap_monitoring(), Utility.resume_heap_monitoring(), and Utility.take_heap_snapshot().

get_spin_per_microsecond()

static native long get_spin_per_microsecond ( )

static

Returns the number of spin operations to perform to wait 1 microsecond.

This utility can be used to measure how many spin operations must be performed to wait 1 microsecond. Since the time that it takes the CPU to perform 1 spin operation depends on the CPU frequency, it is recommended to use this utility before using spin().

Returns

Number of spin operations to wait 1 microsecond.

See also

com.rti.ndds.utility.Utility.spin

Referenced by Utility.spin().

enable_heap_monitoring()

static native boolean enable_heap_monitoring ( )

static

[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.enable.

Referenced by Utility.spin().

disable_heap_monitoring()

static native void disable_heap_monitoring ( )

static

[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.disable.

Referenced by Utility.spin().

pause_heap_monitoring()

static native boolean pause_heap_monitoring ( )

static

[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.pause.

Referenced by Utility.spin().

resume_heap_monitoring()

static native boolean resume_heap_monitoring ( )

static

[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.resume

Referenced by Utility.spin().

take_heap_snapshot()

static native boolean take_heap_snapshot ( String  filename, boolean  print_details  )

static

[DEPRECATED] See: com.rti.ndds.utility.HeapMonitoring.take_heap_snapshot.

Referenced by Utility.spin().