From Gnash Project Wiki
Soft references are 'movieclip' value types in ActionScript. They are special in that they don't keep the pointed object alive, they become invalid when the pointed object is removed and they point to any new object which is placed at the same target. Referencing string seems to be the movieclip target. Anyway some tests show oddities introduced when changing the _name property of any component of the full target.
Here are some more external informations:
- Forum post by Senocular: http://www.actionscript.org/forums/showpost.php3?p=491633&postcount=19
- Flashcoders mailing list post: http://thread.gmane.org/gmane.comp.web.flashcoders.devel/84030
- http://www.kirupa.com/developer/oop/AS1OOPObjectBasics3.htm - another introduction
- Colin Mooks's book: ActionScript: The definitive guide
Attempts to test this are in the MovieClip.as testcase.
Suppose you don't want to review all those things, here is a short test, see if you could provide a model to solve/survive the following tests:)
//create a movieclip mcRef = this.createEmptyMovieClip("mc", 10); check(typeof(mc)=='movieclip'); check(typeof(mcRef)=='movieclip'); check(mc == _level0.mc); check(mcRef == _level0.mc); //change the "_name" property mc._name = 'changed'; check(typeof(mc)=='undefined'); check(typeof(mcRef)=='movieclip'); check(mc == undefined); check(mcRef == _level0.changed); // remove the created moiveclip changed.removeMovieClip(); check(typeof(mc) == 'undefined'); check(typeof(mcRef) == 'movieclip'); check(mc == undefined); check(mcRef.valueOf() == null); //re-create a movieclip again this.createEmptyMovieClip("mc", 20); check(typeof(mc)=='movieclip'); check(typeof(mcRef)=='movieclip'); check(mc == _level0.mc); check(mcRef == _level0.mc);
MovieClip values are stored as string copies of the clip's target path. When a movieclip value is dereferenced it resolves the target path dynamically and returns any object found, possibly NULL if none is found.
A problem shown by the recent tests in MovieClip.as testcase is that changing the _name property of any component of the path makes dynamic resolution of the cached target path fail, while the proprietary player seems to retain the reference to it's original (!!).
Any help with solving this puzzle is welcome.
MovieClip values are stored by pointer. When a movieclip value is dereferenced, the status of the pointed-to MovieClip is checked. If it is unloaded, then it's targetPath is used to find any other MovieClip placed at that target, and the new one is returned (or NULL, of no other).
Question: How do you know the instances pointed by the pointer is valid(not destroyed) before you dereference it? --zou
Answer: as_value checks with isUnloaded(). This is sub-optimal but works correctly, as any removed-but-still-referenceable sprite can still be found by target value, so any dereferencing will keep scanning the displaylist for a match in target name, which could be avoided by checking for another flag (ie: isRemoved) in which case we'll need to notify real removals of the characters *after* executing any pending onUnload event hanlder (should'nt be too hard, doing so in DisplayList::removeUnloaded)
Should be checked what happens with 'this' variables in onUnload methods. already tested, see misc-ming.all/unload_movieclip_test1.c