[#absl-Cord-AdvanceAndRead]
= xref:absl.adoc[absl]::xref:absl/Cord.adoc[Cord]::AdvanceAndRead
:relfileprefix: ../../
:mrdocs:

Advances the `Cord::CharIterator` by `n_bytes` and returns the bytes advanced as a separate `Cord`.

== Synopsis

Declared in `<absl/strings/cord.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:absl/Cord.adoc[Cord]
AdvanceAndRead(
    xref:absl/Cord/CharIterator.adoc[CharIterator]* it,
    size_t n_bytes);
----

== Description

`n_bytes` must be less than or equal to the number of bytes within the Cord; otherwise, behavior is undefined. It is valid to pass `char_end()` and `0`.

== Return Value

A Cord holding the bytes advanced over.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *it*
| The iterator to advance.
| *n_bytes*
| The number of bytes to advance and read.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#