Open Radar

 
Summary:
UISegmentedControl's -setImage:forSegmentAtIndex: and -setTitle:forSegmentAtIndex: are documented to behave as follows: "An index number identifying a segment in the control. It must be a number between 0 and the number of segments (numberOfSegments) minus 1; values exceeding this upper range are pinned to it." However this is not true. Instead, an exception is thrown.

Steps to Reproduce:
1. create a new iOS application in Xcode 4.6.3 and paste the following lines into -application:didFinishLaunching:withOptions: just after creating the window. 

    UISegmentedControl *segmentedControl = [[UISegmentedControl alloc] initWithItems:@[@"Foo", @"Bar", @"Baz"]];
    [segmentedControl setTitle:@"Qux" forSegmentAtIndex:10];
    NSLog(@"segment titles: %@, %@, %@", [segmentedControl titleForSegmentAtIndex:0], [segmentedControl titleForSegmentAtIndex:1], [segmentedControl titleForSegmentAtIndex:2]);

2. Run the project

Expected Results:
The Baz label should be replaced with a Qux label.

Actual Results:
The application crashes due to an NSRangeException exception. 

Regression:
Unknown

Notes:
Possibly a documentation bug. Workaround: pin to the range yourself before calling.