Overview
C API (Core)
struct GetRandomSeed { Symbol hCaller; UINT32* seed; UINT32 count; }; Symbol brahms_getRandomSeed(struct GetRandomSeed* data);

Get a random seed for use by the calling Component.

Notes
  • Two calling protocols are used, listed below. The two call protocol is needed if the component wishes to use exactly the seed that was specified in the SystemML document. If the component would rather have a seed of a fixed length and is happy to let the framework grow this from the seed specified in the SystemML document, only the second call is required.

First Call

Arguments

Symbol hCaller IN
The calling Component.
UINT32* seed IN
Must be NULL.
UINT32 count IN
Must be zero.

Return Values

See also General API Return Values.

Result

  • count is set to the length of seed available in the SystemML document for this component, or zero to indicate that a seed of indefinite length is available.

Second Call

Arguments

Symbol hCaller IN
The calling Component.
UINT32* seed IN
Points to a storage buffer having space for at least count elements (UINT32 elements).
UINT32 count IN
Number of seed elements which are required.

Return Values

See also General API Return Values.

Result

  • The buffer pointed to by seed is filled with count seed elements. If more elements were requested than were available, the returned seed is padded with 0xAAAAAAAA.