User Guide

20 Server-Side ActionScript Language Reference
See also
SharedObject.handlerName
Application.clearSharedObjects()
Availability
Flash Communication Server MX 1.0.
Usage
application.clearSharedObjects(soPath)
Parameters
soPath A string that indicates the URI of a shared object.
Returns
A Boolean value of true if the shared object at the specified path was deleted; otherwise,
false. If using wildcard characters to delete multiple files, the method returns true only if all
the shared objects matching the wildcard pattern were successfully deleted; otherwise, it will
return
false.
Description
Method; deletes persistent shared objects (FSO files) specified by the soPath parameter and
clears all properties from active shared objects (persistent and nonpersistent).
The
soPath parameter specifies the name of a shared object, which can include a slash (/) as a
delimiter between directories in the path. The last element in the path can contain wildcard
patterns (for example, a question mark [?] and an asterisk [*]) or a shared object name. The
application.clearSharedObjects() method traverses the shared object hierarchy along
the specified path and clears all the shared objects. Specifying a slash (/) clears all the shared
objects associated with an application instance.
The following values are possible for the
soPath parameter:
■ / clears all local and persistent shared objects associated with the instance.
■ /foo/bar clears the shared object /foo/bar; if bar is a directory name, no shared objects
are deleted.
■ /foo/bar/* clears all shared objects stored under the instance directory /foo/bar. The bar
directory is also deleted if no persistent shared objects are in use within this namespace.
■ /foo/bar/XX?? clears all shared objects that begin with XX, followed by any two
characters. If a directory name matches this specification, all the shared objects within this
directory are cleared.