Objects and Interfaces

brightscript objects though brightscript operates independently of its object architecture and library, they are both required for programming brightscript applications the api of a brightsign platform is exposed to brightscript as a library objects platforms must register a new brightscript object to expose some part of its api brightscript objects are written in c (or a compatible language such as c++), and are robust against version changes scripts are generally backwards compatible with objects that have undergone revisions brightscript objects keep a reference count; they delete themselves when the reference count reaches zero wrapper objects all intrinsic brightscript types (boolean, integer, float, double, string, and invalid) have object equivalents if one of these intrinsic types is passed to a function that expects an object, the appropriate wrapper object will be created, assigned the correct value, and passed to the function (this is sometimes referred to as "autoboxing") this allows, for example, roarray objects to store values (e g integers and strings) as well as objects any expression that expects one of the above types will work with the corresponding wrapper object as well roboolean , roint , rofloat , rodouble , rostring the following examples illustrate how wrapper objects work print 5 tostr()+"th" print "5" toint()+5 5 tostr() 'this will cause an error instead, use the following ( 5) tostr() if type(5 tostr())<> "string" then stop if ( 5) tostr()<>" 5" then stop if (1+2) tostr()<>"3" then stop i= 55 if i tostr()<>" 55" then stop if 100% tostr()<>"100" then stop if ( 100%) tostr()<>" 100" then stop y%=10 if y% tostr()<>"10" then stop if "5" toint()<>5 or type("5" toint())<>"integer" then stop if "5" tofloat()<>5 0 or type("5" tofloat())<>"float" then stop fs=" 1 1" if fs tofloat()<> 1 1 or fs toint()<> 1 then stop if "01234567" left(3)<>"012" then stop if "01234567" right(4)<>"4567" then stop if "01234567" mid(3)<>"34567" then stop if "01234567" mid(3,1)<>"3" then stop if "01234567" instr("56")<>5 then stop if "01234567" instr(6,"56")<> 1 then stop if "01234567" instr(0,"0")<>0 then stop interfaces interfaces in brightscript operate similarly to java or microsoft com an interface is a known set of member functions that implement a set of logic in some ways, an interface is similar to a virtual base class in c++; any script or program that is compatible with c can use an object interface without regards to the type of object it belongs to for example, the roserialport object, which controls the standard serial interface, implements three interfaces ifserialcontrol , ifstreamreceive , and ifstreamsend since the print statement sends its output to any object that has an ifstreamsend interface, it works with the roserialport object, as well as any other object with the ifstreamsend interface statement and interface integration some brightscript statements have integrated functionality with interfaces this section describes how to use statements with interfaces print using the print statement in the following format will print into an object that has an ifstreamsend interface, including the rotextfield and roserialport objects port = createobject("roserialport",0,115200) print port, "string" if the expression being printed evaluates to an object with an ifenum interface, the print statement will print every item that can be enumerated in addition to printing the values of intrinsic types, the print statement can also be used to print any object that exposes one of the following interfaces ifstring , ifint , iffloat wait the wait statement can work in conjunction with any object that has an ifmessageport interface expression parsing any expression that expects a certain type of variable—including integer, float, double, boolean, or string—can accept an object with an interface equivalent of that type ifint , iffloat , ifdouble , ifboolean , ifstring array operator the \[ ] array operator works with any object that has an ifarray or ifassociativearray interface, including arrays, associative arrays, and lists member access operator the member access operator (i e operators docid\ pl6ydtpgctydca5q2bw45 ) works with any object that has an ifassociativearray interface it also works with any object when used to call a member function (i e method) it also has special meaning when used on an roxmlelement or roxmllist object