---
title: CGContextClipToRects
framework: coregraphics
role: symbol
role_heading: Function
path: coregraphics/cgcontextcliptorects
---

# CGContextClipToRects

Sets the clipping path to the intersection of the current clipping path with the region defined by an array of rectangles.

## Declaration

```occ
extern void CGContextClipToRects(CGContextRef c, const CGRect *rects, size_t count);
```

## Parameters

- `c`: The graphics context for which to set the clipping path.
- `rects`: An array of rectangles. The locations and dimensions of the rectangles are specified in the user space coordinate system.
- `count`: The total number of array entries in the rects parameter.

## Discussion

Discussion This function sets the clipping path to the intersection of the current clipping path and the region within the specified rectangles. After determining the new clipping path, the function resets the context’s current path to an empty path.

## See Also

### Working with the Current Clipping Path

- [clip(to:)](coregraphics/cgcontext/clip(to:)-7cbwq.md)
- [clip(to:mask:)](coregraphics/cgcontext/clip(to:mask:).md)
- [boundingBoxOfClipPath](coregraphics/cgcontext/boundingboxofclippath.md)
- [CGContextClip](coregraphics/cgcontextclip.md)
- [CGContextEOClip](coregraphics/cgcontexteoclip.md)