contents   index   previous   next



sePutNullEx

 

syntax:

   boolean

SEContext.sePutBoolEx(SEObject obj,

                      SEMemberDesc mem,

                      int fl,

                      boolean val);

 

   boolean

SEContext.sePutNumberEx(SEObject obj,

                        SEMemberDesc mem,

                        int fl,

                        double val);

 

   boolean

SEContext.sePutPointerEx(SEObject obj,

                         SEMemberDesc mem,

                         int fl,

                         Object val);

 

   boolean

SEContext.sePutObjectEx(SEObject obj,

                        SEMemberDesc mem,

                        int fl,

                        SEObject val);

 

   boolean

SEContext.sePutStringEx(SEObject obj,

                        SEMemberDesc mem,

                        int fl,

                        String val);

 

   boolean

SEContext.sePutStringEx(SEObject obj,

                        SEMemberDesc mem,

                        int fl,

                        String val,

                        int len);

 

   boolean

SEConext.sePutUndefinedEx(SEObject obj,

                          SEMemberDesc mem,

                          int fl);

 

   boolean

SEContext.sePutNullEx(SEObject obj,

                      SEMemberDesc mem,

                      int fl);

where:

object the object half of an Object,Member pair

 

mem the member half of an Object,Member pair

 

fl flags determining how the variable is stored

 

val the value to put, type based on which routine you are using

 

len for the overloaded version of sePutString, the length in characters of the String to be put. If len is less than the actual length of the String, only len characters will be put.

 

return:

The boolean true if the member was created, false if it already existed.

 

description:

These functions are the inverse of the seGetXXX versions, they put a value into the given Object,Member location. Like their get counterparts, these functions have versions that make the flags implicit in their name. However, there is one additional flag, SE.GF_MUST. SE.GF_MUST means that the value should ignore the SE.READONLY attribute. This eases updating internal members in your objects that should be read-only for the script but not for you. It is equivelent to turning off the read-only bit, putting the value, then turning it back on. It is most-often used in combination with SE.GF_DIRECT. Here are the name/flag equivelents using sePutNumberEx as an example:

 

sePutNumber(...) = sePutNumberEx(...,SE.GF_DEFAULT)

 

sePutDirectNumber(...) = sePutNumberEx(...,SE.GF_DIRECT)

 

seMustPutNumber(...) = sePutNumberEx(...,SE.GF_MUST)

 

seMustPutDirectNumber(...) = sePutNumberEx(...,SE.GF_MUST|SE.GF_DIRECT)

see:

None

 


seDelete