[#util-SplitString-0e]
= xref:util.adoc[util]::SplitString
:relfileprefix: ../
:mrdocs:

`SplitString` overloads

== Synopses

Declared in `<util/string.h>`

Split a string on a single separator character, returning strings.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[nodiscard]]
std::vector<std::string>
xref:util/SplitString-0b.adoc[SplitString](
    std::string_view str,
    char sep);
----

[.small]#xref:util/SplitString-0b.adoc[_» more..._]#

Split a string on any of the given separator characters, returning strings.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[nodiscard]]
std::vector<std::string>
xref:util/SplitString-08.adoc[SplitString](
    std::string_view str,
    std::string_view separators);
----

[.small]#xref:util/SplitString-08.adoc[_» more..._]#

== Return Value

* The pieces of str between occurrences of sep.
* The pieces of str between separators.

[NOTE]
====
The return value https://en.cppreference.com/cpp/language/attributes/nodiscard[should not be discarded^].
====
== Parameters

[cols="1,4"]
|===
| Name| Description
| *str*
| Input string to split.
| *sep*
| Separator character.
| *separators*
| Set of characters, any of which splits the input.
|===


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