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

A range over the characters of a `Cord`, usable in a range‐based for loop.

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class CharRange;
----

== Description

`CharRange` is a helper class for iterating over the characters of a producing an iterator which can be used within a range‐based for loop. Construction of a `CharRange` will return an iterator pointing to the first character of the Cord. Generally, do not construct a `CharRange` directly; instead, prefer to use the `Cord::Chars()` method shown below.

Implementation note: `CharRange` is simply a convenience wrapper over `Cord::char_begin()` and `Cord::char_end()`.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:absl/Cord/CharRange/const_iterator.adoc[`const_iterator`] 
| The const iterator type for the range.
| xref:absl/Cord/CharRange/const_reference.adoc[`const_reference`] 
| The const reference type for the values in the range.
| xref:absl/Cord/CharRange/iterator.adoc[`iterator`] 
| The iterator type for the range.
| xref:absl/Cord/CharRange/reference.adoc[`reference`] 
| The reference type for the values in the range.
| xref:absl/Cord/CharRange/value_type.adoc[`value_type`] 
| The type of the values in the range.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:absl/Cord/CharRange/2constructor.adoc[`CharRange`]         [.small]#[constructor]#
| Constructs a range over the characters of `cord`.
| xref:absl/Cord/CharRange/begin.adoc[`begin`] 
| Returns an iterator to the first character of the range.
| xref:absl/Cord/CharRange/end.adoc[`end`] 
| Returns an iterator one past the last character of the range.
|===



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