| Package | lopsae.lif.colecciones |
| Interface | public interface Coleccion extends Borrable |
| Subinterfaces | Lista |
| Implementors | ColeccionAbstracta |
Dependiendo de la naturaleza de la colección a implementar algunas de las
funciones de la interface podrían verse incapaces de ejecutar la acción
propuesta. Dichas funciones son las que modifican el contenido de la
colección (a excepción de vaciar, que siempre debe de ejecutar
exitosamente), y regresan un valor booleano indicando si la operación
se completo exitosamente.
Algunas funciones requieren evaluar igualdad entre objetos. Por omisión
el comportamiento de las instancias es evaluar igualdad mediante
igualdad referencial, es decir que dos objetos son iguales si ambos
apuntan al mismo objeto. Utilizando la función usarIgualables
la instancia debe de evaluar si los objetos contenidos puede convertirse
en instancias de Igualable, y de ser así, utilizar dicha interface
para evaluar igualdad. Si uno de los objetos a evaluar no puede ser
convertido a una instancia de Igualable, la evaluación de igualdad se
hará mediante igualdad referencial.
See also
| Method | Defined by | ||
|---|---|---|---|
|
agregar(objeto:Object):Boolean
Agrega un objeto a la instancia.
| Coleccion | ||
|
agregarTodos(coleccion:Coleccion):Boolean
Agrega una colección de objetos a la instancia.
| Coleccion | ||
 |
borrar():void
Libera toda referencia interna que contenga la instancia.
| Borrable | |
|
contiene(objeto:Object):Boolean
Evalúa si la instancia contiene a
objeto. | Coleccion | ||
|
contieneTodos(coleccion:Coleccion):Boolean
Evalúa si la instancia contiene todos los objetos que contiene
coleccion. | Coleccion | ||
|
Genera y regresa un iterador de la instancia.
| Coleccion | ||
|
remover(objeto:Object):Boolean
Remueve un objeto de la instancia.
| Coleccion | ||
|
removerTodos(coleccion:Coleccion):Boolean
Remueve una colección de objetos de la instancia.
| Coleccion | ||
|
retenerTodos(coleccion:Coleccion):Boolean
Retiene en la instancia aquellos objetos que también estén en
coleccion. | Coleccion | ||
|
usaIgualables():Boolean
Regresa
true si la evaluación de igualdad se ejecuta
mediante la interface Igualable, o false de lo
contrario. | Coleccion | ||
|
usarIgualables(usar:Boolean):void
Habilita o deshabilita que esta colección ejecute evaluaciones
de igualdad entre objetos implementando la interface Igualable.
| Coleccion | ||
|
vaciar():void
Vacía la instancia de objetos contenidos.
| Coleccion | ||
|
verNumeroDeElementos():int
Regresa el número de elementos que contiene la instancia.
| Coleccion | ||
| agregar | () | method |
Hide Inherited Public Methods
Show Inherited Public Methodspublic function agregar(objeto:Object):BooleanAgrega un objeto a la instancia.
Parametersobjeto:Object — el objeto a agregar.
|
Boolean — true si el objeto fue agregado exitosamente,
false de lo contrario.
|
| agregarTodos | () | method |
public function agregarTodos(coleccion:Coleccion):BooleanAgrega una colección de objetos a la instancia.
Parameterscoleccion:Coleccion — la colección de objetos a agregar.
|
Boolean — true si los objetos de la colección fueron agregados
exitosamente, false de lo contrario.
|
| contiene | () | method |
public function contiene(objeto:Object):Boolean
Evalúa si la instancia contiene a objeto.
Esta función utilizará la interface Igualable para evaluar
igualdad entre objetos si dicha funcionalidad es habilitada mediante
la función usarIgualables.
objeto:Object — el objeto a evaluar por contención.
|
Boolean — true si la instancia contiene a objeto,
false de lo contrario.
|
| contieneTodos | () | method |
public function contieneTodos(coleccion:Coleccion):Boolean
Evalúa si la instancia contiene todos los objetos que contiene coleccion.
Esta función utilizará la interface Igualable para evaluar
igualdad entre objetos si dicha funcionalidad es habilitada mediante
la función usarIgualables.
coleccion:Coleccion — la colección de objetos a evaluar por contención.
|
Boolean — true si la instancia contiene todos los objetos que
contiene coleccion, false de lo contrario.
|
| generarIterador | () | method |
public function generarIterador():IteradorGenera y regresa un iterador de la instancia.
ReturnsIterador —
un iterador de la instancia.
|
| remover | () | method |
public function remover(objeto:Object):BooleanRemueve un objeto de la instancia.
Esta función utilizará la interface Igualable para evaluar
igualdad entre objetos si dicha funcionalidad es habilitada mediante
la función usarIgualables.
objeto:Object — el objeto a remover.
|
Boolean — true si el objeto fue removido exitosamente,
false de lo contrario.
|
| removerTodos | () | method |
public function removerTodos(coleccion:Coleccion):BooleanRemueve una colección de objetos de la instancia.
Esta función utilizará la interface Igualable para evaluar
igualdad entre objetos si dicha funcionalidad es habilitada mediante
la función usarIgualables.
coleccion:Coleccion — la colección de objetos a remover.
|
Boolean — true si los objetos de la colección fueron removidos
exitosamente, false de lo contrario.
|
| retenerTodos | () | method |
public function retenerTodos(coleccion:Coleccion):Boolean
Retiene en la instancia aquellos objetos que también estén en coleccion.
Es decir, remueve de la instancia todo objeto que no se encuentre en coleccion.
Esta función utilizará la interface Igualable para evaluar
igualdad entre objetos si dicha funcionalidad es habilitada mediante
la función usarIgualables.
coleccion:Coleccion — la colección que indica que objetos se retienen.
|
Boolean — true si los objetos de la colección fueron retenidos
exitosamente, false de lo contrario.
|
| usaIgualables | () | method |
public function usaIgualables():Boolean
Regresa true si la evaluación de igualdad se ejecuta
mediante la interface Igualable, o false de lo
contrario.
Boolean — true si la evaluación de igualdad se ejecuta
mediante la interface Igualable, o false de lo
contrario.
|
| usarIgualables | () | method |
public function usarIgualables(usar:Boolean):voidHabilita o deshabilita que esta colección ejecute evaluaciones de igualdad entre objetos implementando la interface Igualable.
Parametersusar:Boolean — true para que en evaluaciones de igualdad se
realicen mediante la interface Igualable, false para que en evaluaciones
de igualdad se realicen mediante igualdad referencial.
|
See also
| vaciar | () | method |
public function vaciar():voidVacía la instancia de objetos contenidos. Después de esta llamada el número de elementos en la instancia será cero.
| verNumeroDeElementos | () | method |
public function verNumeroDeElementos():intRegresa el número de elementos que contiene la instancia.
Returnsint — el número de elementos que contiene la instancia.
|