cairo:surface-copy-page (surface)

surface -- a cairo:surface-t instance

Emits the current page for backends that support multiple pages, but does not clear it, so that the contents of the current page will be retained for the next page. Use the cairo:surface-show-page function if you want to get an empty page after the emission.

There is a convenience function for this that takes a cairo:context-t context, namely the cairo:copy-page function.