[#llvm-SplitBlock-09]
= xref:llvm.adoc[llvm]::SplitBlock
:relfileprefix: ../
:mrdocs:

Split a block at an instruction using a dominator‐tree updater.

== Synopsis

Declared in `<llvm/Transforms/Utils/BasicBlockUtils.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:llvm/BasicBlock.adoc[BasicBlock]*
SplitBlock(
    xref:llvm/BasicBlock.adoc[BasicBlock]* Old,
    xref:llvm/Instruction.adoc[Instruction]* SplitPt,
    xref:llvm/DomTreeUpdater.adoc[DomTreeUpdater]* DTU = nullptr,
    xref:llvm/LoopInfo.adoc[LoopInfo]* LI = nullptr,
    xref:llvm/MemorySSAUpdater.adoc[MemorySSAUpdater]* MSSAU = nullptr,
    xref:llvm/Twine.adoc[Twine] const& BBName = "");
----

== Return Value

The newly created successor block containing instructions from `SplitPt` onward.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *Old*
| Block to split.
| *SplitPt*
| First instruction moved into the new block.
| *DTU*
| Optional dominator‐tree updater for CFG changes.
| *LI*
| Optional loop info to update.
| *MSSAU*
| Optional MemorySSA updater for the split.
| *BBName*
| Optional name for the newly created block.
|===


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