A basic block represents a single entry single exit section of code. More...

Collaboration diagram for Basic Block:

Functions
LLVMValueRef	LLVMBasicBlockAsValue (LLVMBasicBlockRef BB)
	Convert a basic block instance to a value type.

LLVMBool	LLVMValueIsBasicBlock (LLVMValueRef Val)
	Determine whether an LLVMValueRef is itself a basic block.

LLVMBasicBlockRef	LLVMValueAsBasicBlock (LLVMValueRef Val)
	Convert an LLVMValueRef to an LLVMBasicBlockRef instance.

const char *	LLVMGetBasicBlockName (LLVMBasicBlockRef BB)
	Obtain the string name of a basic block.

LLVMValueRef	LLVMGetBasicBlockParent (LLVMBasicBlockRef BB)
	Obtain the function to which a basic block belongs.

LLVMValueRef	LLVMGetBasicBlockTerminator (LLVMBasicBlockRef BB)
	Obtain the terminator instruction for a basic block.

unsigned	LLVMCountBasicBlocks (LLVMValueRef Fn)
	Obtain the number of basic blocks in a function.

void	LLVMGetBasicBlocks (LLVMValueRef Fn, LLVMBasicBlockRef *BasicBlocks)
	Obtain all of the basic blocks in a function.

LLVMBasicBlockRef	LLVMGetFirstBasicBlock (LLVMValueRef Fn)
	Obtain the first basic block in a function.

LLVMBasicBlockRef	LLVMGetLastBasicBlock (LLVMValueRef Fn)
	Obtain the last basic block in a function.

LLVMBasicBlockRef	LLVMGetNextBasicBlock (LLVMBasicBlockRef BB)
	Advance a basic block iterator.

LLVMBasicBlockRef	LLVMGetPreviousBasicBlock (LLVMBasicBlockRef BB)
	Go backwards in a basic block iterator.

LLVMBasicBlockRef	LLVMGetEntryBasicBlock (LLVMValueRef Fn)
	Obtain the basic block that corresponds to the entry point of a function.

void	LLVMInsertExistingBasicBlockAfterInsertBlock (LLVMBuilderRef Builder, LLVMBasicBlockRef BB)
	Insert the given basic block after the insertion point of the given builder.

void	LLVMAppendExistingBasicBlock (LLVMValueRef Fn, LLVMBasicBlockRef BB)
	Append the given basic block to the basic block list of the given function.

LLVMBasicBlockRef	LLVMCreateBasicBlockInContext (LLVMContextRef C, const char *Name)
	Create a new basic block without inserting it into a function.

LLVMBasicBlockRef	LLVMAppendBasicBlockInContext (LLVMContextRef C, LLVMValueRef Fn, const char *Name)
	Append a basic block to the end of a function.

LLVMBasicBlockRef	LLVMAppendBasicBlock (LLVMValueRef Fn, const char *Name)
	Append a basic block to the end of a function using the global context.

LLVMBasicBlockRef	LLVMInsertBasicBlockInContext (LLVMContextRef C, LLVMBasicBlockRef BB, const char *Name)
	Insert a basic block in a function before another basic block.

LLVMBasicBlockRef	LLVMInsertBasicBlock (LLVMBasicBlockRef InsertBeforeBB, const char *Name)
	Insert a basic block in a function using the global context.

void	LLVMDeleteBasicBlock (LLVMBasicBlockRef BB)
	Remove a basic block from a function and delete it.

void	LLVMRemoveBasicBlockFromParent (LLVMBasicBlockRef BB)
	Remove a basic block from a function.

void	LLVMMoveBasicBlockBefore (LLVMBasicBlockRef BB, LLVMBasicBlockRef MovePos)
	Move a basic block to before another one.

void	LLVMMoveBasicBlockAfter (LLVMBasicBlockRef BB, LLVMBasicBlockRef MovePos)
	Move a basic block to after another one.

LLVMValueRef	LLVMGetFirstInstruction (LLVMBasicBlockRef BB)
	Obtain the first instruction in a basic block.

LLVMValueRef	LLVMGetLastInstruction (LLVMBasicBlockRef BB)
	Obtain the last instruction in a basic block.

Detailed Description

A basic block represents a single entry single exit section of code.

Basic blocks contain a list of instructions which form the body of the block.

Basic blocks belong to functions. They have the type of label.

Basic blocks are themselves values. However, the C API models them as LLVMBasicBlockRef.

See also: llvm::BasicBlock

Function Documentation

◆ LLVMAppendBasicBlock()

LLVMBasicBlockRef LLVMAppendBasicBlock	(	LLVMValueRef	Fn,
		const char *	Name
	)

Append a basic block to the end of a function using the global context.

See also: llvm::BasicBlock::Create()

Definition at line 2767 of file Core.cpp.

References LLVMAppendBasicBlockInContext(), LLVMGetGlobalContext(), and Name.

◆ LLVMAppendBasicBlockInContext()

LLVMBasicBlockRef LLVMAppendBasicBlockInContext	(	LLVMContextRef	C,
		LLVMValueRef	Fn,
		const char *	Name
	)

Append a basic block to the end of a function.

See also: llvm::BasicBlock::Create()

Definition at line 2761 of file Core.cpp.

References llvm::CallingConv::C, llvm::BasicBlock::Create(), Name, llvm::unwrap(), and llvm::wrap().

Referenced by LLVMAppendBasicBlock().

◆ LLVMAppendExistingBasicBlock()

void LLVMAppendExistingBasicBlock	(	LLVMValueRef	Fn,
		LLVMBasicBlockRef	BB
	)

Append the given basic block to the basic block list of the given function.

See also: llvm::Function::BasicBlockListType::push_back()

Definition at line 2756 of file Core.cpp.

References llvm::unwrap().

◆ LLVMBasicBlockAsValue()

LLVMValueRef LLVMBasicBlockAsValue ( LLVMBasicBlockRef BB )

Convert a basic block instance to a value type.

Definition at line 2673 of file Core.cpp.

References llvm::unwrap(), and llvm::wrap().

◆ LLVMCountBasicBlocks()

unsigned LLVMCountBasicBlocks ( LLVMValueRef Fn )

Obtain the number of basic blocks in a function.

Parameters

Fn	Function value to operate on.

Definition at line 2697 of file Core.cpp.

◆ LLVMCreateBasicBlockInContext()

LLVMBasicBlockRef LLVMCreateBasicBlockInContext	(	LLVMContextRef	C,
		const char *	Name
	)

Create a new basic block without inserting it into a function.

See also: llvm::BasicBlock::Create()

Definition at line 2743 of file Core.cpp.

References llvm::CallingConv::C, llvm::BasicBlock::Create(), Name, llvm::unwrap(), and llvm::wrap().

◆ LLVMDeleteBasicBlock()

void LLVMDeleteBasicBlock ( LLVMBasicBlockRef BB )

Remove a basic block from a function and delete it.

This deletes the basic block from its containing function and deletes the basic block itself.

See also: llvm::BasicBlock::eraseFromParent()

Definition at line 2783 of file Core.cpp.

References llvm::unwrap().

◆ LLVMGetBasicBlockName()

const char * LLVMGetBasicBlockName ( LLVMBasicBlockRef BB )

Obtain the string name of a basic block.

Definition at line 2685 of file Core.cpp.

References llvm::unwrap().

◆ LLVMGetBasicBlockParent()

LLVMValueRef LLVMGetBasicBlockParent ( LLVMBasicBlockRef BB )

Obtain the function to which a basic block belongs.

See also: llvm::BasicBlock::getParent()

Definition at line 2689 of file Core.cpp.

References getParent(), llvm::unwrap(), and llvm::wrap().

◆ LLVMGetBasicBlocks()

void LLVMGetBasicBlocks	(	LLVMValueRef	Fn,
		LLVMBasicBlockRef *	BasicBlocks
	)

Obtain all of the basic blocks in a function.

This operates on a function value. The BasicBlocks parameter is a pointer to a pre-allocated array of LLVMBasicBlockRef of at least LLVMCountBasicBlocks() in length. This array is populated with LLVMBasicBlockRef instances.

Definition at line 2701 of file Core.cpp.

References llvm::wrap().