Qual è l'argomento stop BOOL * per enumerateObjectsUsingBlock: usato per?

Question

Ultimamente ho utilizzato enumerateObjectsUsingBlock: per le mie esigenze di enumerazione rapida e sto riscontrando difficoltà nell'utilizzo di BOOL *stop nel blocco di enumerazione.

Gli stati di riferimento NSArray classe

stop: Un riferimento a un valore booleano. Il blocco può impostare il valore su YES su interrompere l'ulteriore elaborazione dell'array. L'argomento stop è un argomento solo-out . Dovresti sempre impostare questo booleano su YES all'interno del blocco .

Così poi, naturalmente, posso aggiungere il seguente nel mio blocco per fermare l'enumerazione:

if (idx == [myArray indexOfObject:[myArray lastObject]]) { 
    *stop = YES; 
} 

Da quello che ho potuto dire, non impostando esplicitamente *stop-YES non ha eventuali effetti collaterali negativi. L'enumerazione sembra fermarsi automaticamente alla fine dell'array. Quindi è davvero necessario usare *stop in un blocco?

Answer 1

L'argomento stop per il blocco consente di interrompere l'enumerazione in anticipo. È l'equivalente di break da un normale ciclo for. Puoi ignorarlo se vuoi passare attraverso ogni oggetto dell'array.

for(id obj in arr){ 
    if([obj isContagious]){ 
     break; // Stop enumerating 
    } 

    if(![obj isKindOfClass:[Perefrigia class]]){ 
     continue; // Skip this object 
    } 

    [obj immanetizeTheEschaton]; 
} 

---

[arr enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) { 
    if([obj isContagious]){ 
     *stop = YES; // Stop enumerating 
     return; 
    } 

    if(![obj isKindOfClass:[Perefrigia class]]){ 
     return; // Skip this object 
    } 

    [obj immanentizeTheEschaton]; 
}]; 

Questo è un parametro fuori perché è un riferimento ad una variabile dall'ambito chiamante. Deve essere impostato all'interno del blocco, ma leggere all'interno di enumerateObjectsUsingBlock:, allo stesso modo NSError s vengono comunemente passati al codice dalle chiamate del framework.

- (void)enumerateObjectsUsingBlock:(void (^)(id obj, NSUInteger idx, BOOL *stop))block { 
    // N.B: This is probably not how this method is actually implemented! 
    // It is just to demonstrate how the out parameter operates! 

    NSUInteger idx = 0; 
    for(id obj in self){ 

     BOOL stop = NO; 

     block(obj, idx++, &stop); 

     if(stop){ 
      break; 
     } 
    } 
}