View source for r7.1.0:Macro LFDS710 STACK SET VALUE IN ELEMENT

{{DISPLAYTITLE:macro LFDS710_STACK_SET_VALUE_IN_ELEMENT}}
==Source Files==
 └───liblfds710
     └───inc
         └───liblfds710
                 lfds710_stack.h

==Opaque Structures==
 struct [[r7.1.0:struct lfds710_stack_element|lfds710_stack_element]];

==Macro==
 #define LFDS710_STACK_SET_VALUE_IN_ELEMENT( stack_element, new_value )

==Parameters==
''stack_element''
: A ''struct lfds710_stack_element'', which is not currently part of a stack.  Not a pointer to it - the struct itself.

''new_value''
: A pointer, which will be cast by the macro to a ''void *'', which the value in ''stack_element'' is set to.

==Return Value==
No return value.

==Notes==
The value in a stack element can only be set when the element is outside of a stack (i.e. has been popped, or has yet to be pushed).  This macro can be called at any time, but if it is used on an element which is present in a stack, all bets are off - all threads on the logical core which does this will see the change, but there is no guarantee any other logical cores will ever see the change.  You were warned.

As with all ''liblfds'' macros, the macro operates on the structure itself, not a pointer to it.

==Example==
 #include <stdio.h>
 #include "liblfds710.h"
 
 int main()
 {
   char
     stack_element_name[64] = "Dr. Hildegarde Langstrom",
     *stack_element_name_temp;
 
   struct lfds710_misc_prng_state
     ps;
 
   struct lfds710_stack_element
     se,
     *se_temp;
 
   struct lfds710_stack_state
     ss;
 
   lfds710_misc_library_init_valid_on_current_logical_core();
  
   lfds710_misc_prng_init( &ps );
 
   lfds710_stack_init_valid_on_current_logical_core( &ss, NULL );
 
   LFDS710_STACK_SET_VALUE_IN_ELEMENT( &se, stack_element_name );
 
   lfds710_stack_push( &ss, &se, &ps );
 
   lfds710_stack_pop( &ss, &se_temp, &ps );
 
   stack_element_name_temp = (char *) LFDS710_STACK_GET_VALUE_FROM_ELEMENT( *ss_temp );
 
   printf( "stack element name is \"%s\"\n", (char *) stack_element_name_temp );
 
   lfds710_stack_cleanup( &ss, NULL );
 
   lfds710_misc_library_cleanup();
 
   return( EXIT_SUCCESS );
 }

==See Also==
* [[r7.1.0:Stack|Stack]]
* ''[[r7.1.0:macro LFDS710_STACK_GET_VALUE_FROM_ELEMENT|LFDS710_STACK_GET_VALUE_FROM_ELEMENT]]''