¿Alguien sabe cómo implementar el protocolo NSFastEnumeration?

Question

Tengo una clase y quiero que mi clase confirme el protocolo NSFastEnumeration. He leído la documentación, pero no está muy claro. ¿Puede alguien decirme por favor qué debe devolver el método de protocolo y cómo funciona? Gracias por adelantado.

Answer 1

Apple FastEnumerationSample le muestra qué hacer, pero aquí hay un desglose.

El único método NSFastEnumeration, countByEnumeratingWithState:objects:count:, devuelve trozos de la colección. Se ejecuta cada vez que se necesitan más elementos, hasta que indica que no hay más elementos devolviendo 0. Se transfiere un fragmento como una matriz C de id s.

Dentro del método, el parámetro state contiene la mayoría (si no todos) de los datos que utilizará. Tendrá que establecer state->itemsPtr y actualizar state->state con cada invocación por separado de countByEnumeratingWithState:objects:count:. He aquí una breve descripción de cada campo de NSFastEnumerationState:

• state: representa la posición en la secuencia que se repiten a lo largo. Para las colecciones indexadas, este sería el índice. Para listas vinculadas, esto podría ser un puntero de nodo. Para otros tipos, este podría ser un tipo más complejo (por ejemplo, para un árbol, state->state podría ser un NSMutableArray utilizado como pila para almacenar nodos). Cuando se llama por primera vez al countByEnumeratingWithState:objects:count:, state->state es 0; compruebe esta condición para inicializar la estructura state.
• itemsPtr: los elementos en el fragmento; apunta a una matriz C de id s. Cocoa recorrerá esta matriz, vinculando cada elemento a la variable nombrada en el bucle for-in.
• mutationsPtr: para colecciones mutables, utilizadas para indicar que la colección ha cambiado desde la última llamada al countByEnumeratingWithState:objects:count:. Normalmente, establecería esto una vez al inicializar el estado. Los mutadores de la colección incrementan el valor que esto apunta. Cocoa comparará el valor devuelto por countByEnumeratingWithState:objects:count: con el valor de la invocación anterior; si son diferentes, Cocoa lanzará una excepción.
• extra: puede usar esto para almacenar datos adicionales.

Puede establecer state->state y cualquier elemento del state->extra a lo que quieran; se proporcionan únicamente para su conveniencia y no afectan a Cocoa. state->itemsPtr, *state->mutationsPtr y el valor devuelto por el método, sin embargo, afectan a Cocoa.

En cuanto a los otros dos parámetros de método, stackbuf es una matriz que Cocoa proporciona para contener elementos. Su uso es opcional, pero si no lo usa, tendrá que asignar espacio de almacenamiento para state->itemPtr. Si lo usa, establezca state->itemsPtr en stackbuf con cada invocación. len es la longitud de stackbuf, la cantidad máxima de elementos que podrá almacenar en ella.

Más información:

• Friday Q&A 2010-04-16: Implementing Fast Enumeration (mikeash.com)
• Implementing countByEnumeratingWithState:objects:count: (Cacao con Amor)
• NSFastEnumeration Protocol Reference
• Implementing NSFastEnumerator on Custom Class (SO)

Answer 2

Sólo la reactivación de este hilo después de encontrar una excelente explicación. El enlace de Apple parece estar roto. Puede intentar aquí: https://developer.apple.com/library/ios/#samplecode/FastEnumerationSample/Introduction/Intro.html

El mejor ejemplo para implementar la enumeración rápida que he encontrado está en: http://mikeash.com/pyblog/friday-qa-2010-04-16-implementing-fast-enumeration.html. Se ve mucho peor de lo que es.