Scribd
Upload
149 views1 page

Block Cheat Sheet

The document defines what a block is in Objective-C and provides examples of how to declare, create, call, pass, copy, release and return blocks. It also demonstrates how to use blocks as callbacks.

Uploaded by

patogenx
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
149 views1 page

Block Cheat Sheet

The document defines what a block is in Objective-C and provides examples of how to declare, create, call, pass, copy, release and return blocks. It also demonstrates how to use blocks as callbacks.

Uploaded by

patogenx
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 1

Yannick Loriot | Block Cheat Sheet

Source: http://yannickloriot.com Copyright (c) 2011 - Yannick Loriot



Definition
A block is an inline anonymous function which can
capture the variables available in its context at the
run-time. It is always created on the stack.
Declaration
// Define a block which return nothing and takes as only
argument a NSString *
void (^block_name)(NSString *);
Typedef

// Doing the same thing using a typedef
typedef void (^MyBlockType)(NSString *);
MyBlockType block_name;
Creation
// Assigning this block to the block_name variable
block_name = ^ void (NSString *parameter) { /* body */ };
Call
// Call the block_name passing a NSString * as parameter
block_name(@"a string");
Passing a block
[foo aMethod: ^ BOOL () { return YES; }];
// Infered return type and skipped argument list
[foo aMethod: ^ { return YES; }];

__block storage type modifier
__block storage type modifier copy the
address/reference of the variable instead of their
value.
__block int x = 0; // Use the __block keyword to be able to
modify it within the block

// Create a block to increment the given variable
void (^increment) () = ^ { x++; };

NSLog(@"%d", x); // "0"
increment();
NSLog(@"%d", x); // "1"
Copy / Release
Block_copy: Move a block on the heap.
Block_release: Release a block.
To avoid a memory leak you must always use a
Block_release function with a Block_copy function.
Return a block example
typedef NSInteger (^PBlock) (NSInteger);

- (PBlock)blockRaisedToPower:(NSInteger)y {
PBlock block = ^ NSInteger (NSInteger x) {
return pow(x, y); // y closure
};
return [[block copy] autorelease]; // Move to the heap
}

- (void)test {
PBlock square = [self blockRaisedToPower:2];
PBlock cube = [self blockRaisedToPower:3];

NSLog(@"%d", square(3)); // 9
NSLog(@"%d", cube(3)); // 27
}
Callback example
// YLAudioPlayer.h
#import <AVFoundation/AVFoundation.h>

typedef void (^YLBlock)(BOOL);
@interface YLAudioPlayer : AVAudioPlayer {
YLBlock block;
}
@property (nonatomic, copy) YLBlock block;

- (id)initWithURL:(NSURL *)url usingBlock:(YLBlock) block;

@end

// YLAudioPlayer.m
#import "YLAudioPlayer.h"
@implementation YLAudioPlayer
@syntesize block;

- (void)dealloc {
// Release the block because it has been copied
[block release], block = nil;
[super dealloc];
}

- (id)initWithURL:(NSURL *)url usingBlock:(YLBlock) block {
if ((self = [super initWithContentsOfURL:url error:nil])) {
self. block = block;
self.delegate = self;
}
return self;
}

- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer
*)player successfully:(BOOL)flag {
// Call the block delegate
block (flag);
}

You might also like