[#BloombergLP-bdlpcre-RegEx-replaceRaw-0a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlpcre.adoc[bdlpcre]::xref:BloombergLP/bdlpcre/RegEx.adoc[RegEx]::replaceRaw
:relfileprefix: ../../../
:mrdocs:

Replace matches in `subject` without validating UTF‐8 in `replacement`.

== Synopsis

Declared in `<bdlpcre_regex.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
replaceRaw(
    xref:bsl/string.adoc[bsl::string]* result,
    int* errorOffset,
    std::string_view const& subject,
    std::string_view const& replacement,
    size_t options = 0) const;
----

== Description

Optionally specify `options` as a bit‐wise OR of `k_REPLACE_*` flags. Return the number of substitutions on success; on error return a negative value and optionally load `errorOffset`. The behavior is undefined unless `true == isPrepared()`.

== Return Value

number of substitutions, or a negative value on error

== Parameters

[cols="1,4"]
|===
| Name| Description
| *result*
| location for the replacement text
| *errorOffset*
| optional location for a syntax‐error offset
| *subject*
| input subject string
| *replacement*
| replacement text
| *options*
| bit‐wise OR of `k_REPLACE_*` flags
|===


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