Apa argumen BOOL * stop untuk enumerateObjectsUsingBlock: digunakan untuk?

enumerateObjectsUsingBlock:Akhir-akhir ini saya banyak menggunakan untuk kebutuhan pencacahan cepat, dan saya mengalami kesulitan memahami penggunaannya BOOL *stopdi blok pencacahan.

The NSArraynegara referensi kelas

stop: Referensi ke nilai Boolean. Blok dapat mengatur nilai YESuntuk menghentikan pemrosesan lebih lanjut dari larik. The stopargumen argumen out-satunya. Anda hanya boleh menyetel Boolean ini ke YESdalam Blok.

Jadi tentu saja saya bisa menambahkan yang berikut ini di blok saya untuk menghentikan pencacahan:

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

Dari apa yang saya sudah bisa memberitahu, tidak secara eksplisit menetapkan *stopuntuk YEStidak memiliki efek samping negatif. Pencacahan tampaknya secara otomatis berhenti sendiri di akhir larik. Jadi, apakah *stopbenar-benar perlu digunakan dalam satu blok?

The stopargumen untuk Blok memungkinkan Anda untuk menghentikan pencacahan sebelum waktunya . Ini setara dengan dari loop breaknormal for. Anda bisa mengabaikannya jika Anda ingin menelusuri setiap objek dalam larik.

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];
}];

Itu adalah parameter keluar karena ini adalah referensi ke variabel dari lingkup pemanggilan. Ini perlu disetel di dalam Blok Anda, tetapi baca di dalamnya enumerateObjectsUsingBlock:, dengan cara yang sama NSErrorbiasanya diteruskan kembali ke kode Anda dari panggilan kerangka kerja.

- (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;
        }
    }
}