diff options
author | Reid Spencer <rspencer@reidspencer.com> | 2007-04-01 08:27:01 +0000 |
---|---|---|
committer | Reid Spencer <rspencer@reidspencer.com> | 2007-04-01 08:27:01 +0000 |
commit | 497d93e61f43fe69030d711e7483adbbb53243fb (patch) | |
tree | 7ba4f87e31fc667024295eb855d86a0e2990e67e /docs | |
parent | 3074d9df96b1b5fa3920672ef7555d3fbbc5bb65 (diff) | |
download | llvm-497d93e61f43fe69030d711e7483adbbb53243fb.tar.gz llvm-497d93e61f43fe69030d711e7483adbbb53243fb.tar.bz2 llvm-497d93e61f43fe69030d711e7483adbbb53243fb.tar.xz |
For PR1297:
Preview documentation for the llvm.bit.concat intrinsic (yet to be
implemented).
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@35552 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
-rw-r--r-- | docs/LangRef.html | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/docs/LangRef.html b/docs/LangRef.html index 8862348196..84e46fb2bc 100644 --- a/docs/LangRef.html +++ b/docs/LangRef.html @@ -4587,6 +4587,52 @@ of src. For example, <tt>llvm.cttz(2) = 1</tt>. </p> </div> +<!-- _______________________________________________________________________ --> +<div class="doc_subsubsection"> + <a name="int_cttz">'<tt>llvm.bit.concat.*</tt>' Intrinsic</a> +</div> + +<div class="doc_text"> + +<h5>Syntax:</h5> +<p>This is an overloaded intrinsic. You can use <tt>llvm.bit.concat</tt> on any +integer bit width. +<pre> + declare i32 @llvm.bit.concat.i32.i17.i15 (i17 %hi, i15 %lo) + declare i29 @llvm.bit.concat.i29(i16 %lo, i13 %lo) +</pre> + +<h5>Overview:</h5> +<p> +The '<tt>llvm.bit.concat</tt>' family of intrinsic functions concatenates two +integer values to produce a longer one. +</p> + +<h5>Arguments:</h5> + +<p> +The two arguments may be any bit width. The result must be an integer whose bit +width is the sum of the arguments' bit widths. The first argument represents the +bits that will occupy the high order bit locations in the concatenated result. +THe second argument will occupy the lower order bit locations in the result. +</p> + +<h5>Semantics:</h5> + +<p> +The '<tt>llvm.bit.concat</tt>' intrinsic is the equivalent of two <tt>zext</tt> +instructions, a <tt>shl</tt> and an <tt>or</tt>. This sequence can be +implemented in hardware so this intrinsic assists with recognizing the sequence +for code generation purposes. The operation proceeds as follows:</p> +<ol> + <li>Each of the arguments is <tt>zext</tt>'d to the result bit width.</li> + <li>The <tt>%hi</tt> argument is shift left by the width of the <tt>%lo</tt> + argument (shifted into to high order bits).</li> + <li>The shifted <tt>%hi</tt> value and <tt>%lo</tt> are <tt>or</tt>'d together + to form the result.</li> +</ol> +</div> + <!-- ======================================================================= --> <div class="doc_subsection"> <a name="int_debugger">Debugger Intrinsics</a> |