reference/functions/nksp_sh_right_function.html

<html>
  <head>
    <meta name="author" content="Christian Schoenebeck">
    <title>sh_right() function</title>
    <meta name="description" content="Calculates a right bit shifted value.">
  </head>
  <body>
    <h1>sh_right()</h1>
    <p>
      Calculates right bit shifted values.
      The original value of the 1st argument is bit shifted to the right as
      many times as requested by the 2nd argument and the result of this
      bit shift operation is returned by this function.
    </p>

    <h3>Function Prototype</h3>
    <p/>
    <code lang="nksp">
sh_right(??number??, ??shifts??)
    </code>

    <h3>Arguments</h3>
    <table>
      <tr>
        <th>Argument Name</th> <th>Data Type</th> <th>Description</th>
      </tr>
      <tr>
        <td><code>??number??</code></td>
        <td>Integer Number</td>
        <td>Original input value to be shifted.<br>
            [required]</td>
      </tr>
      <tr>
        <td><code>??shifts??</code></td>
        <td>Integer Number</td>
        <td>Amount of times the original value should be shifted to the right.<br>
            [required]</td>
      </tr>
    </table>

    <h3>Return Value</h3>
    <table>
      <tr>
        <th>Data Type</th> <th>Description</th>
      </tr>
      <tr>
        <td>Integer Number</td>
        <td>Bit shifted result.</td>
      </tr>
    </table>

    <h3>Remarks</h3>
    <p>
      This functions accepts finalness for its argument <code>??number??</code>.
      The return value's finalness will be identical to <code>??number??</code>'s one.
    </p>

    <h3>Examples</h3>
    <p/>
    <code>
on init
  message("sh_right(128,0) = " & sh_right(128,0))
  message("sh_right(128,1) = " & sh_right(128,1))
  message("sh_right(128,2) = " & sh_right(128,2))
  message("sh_right(128,3) = " & sh_right(128,3))
end on
    </code>

    <h3>See also</h3>
    <p><code>sh_left()</code><p>

    <h3>Availability</h3>
    <p>Since LinuxSampler 2.0.0.svn22.<p>

  </body>
</html>
1	schoenebeck	2966	<html>
2			<head>
3			<meta name="author" content="Christian Schoenebeck">
4			<title>sh_right() function</title>
5			<meta name="description" content="Calculates a right bit shifted value.">
6			</head>
7			<body>
8			<h1>sh_right()</h1>
9			<p>
10			Calculates right bit shifted values.
11			The original value of the 1st argument is bit shifted to the right as
12			many times as requested by the 2nd argument and the result of this
13			bit shift operation is returned by this function.
14			</p>
15
16			<h3>Function Prototype</h3>
17			<p/>
18			<code lang="nksp">
19			sh_right(??number??, ??shifts??)
20			</code>
21
22			<h3>Arguments</h3>
23			<table>
24			<tr>
25			<th>Argument Name</th> <th>Data Type</th> <th>Description</th>
26			</tr>
27			<tr>
28			<td><code>??number??</code></td>
29			<td>Integer Number</td>
30			<td>Original input value to be shifted.<br>
31			[required]</td>
32			</tr>
33			<tr>
34			<td><code>??shifts??</code></td>
35			<td>Integer Number</td>
36			<td>Amount of times the original value should be shifted to the right.<br>
37			[required]</td>
38			</tr>
39			</table>
40	schoenebeck	3601
41	schoenebeck	2966	<h3>Return Value</h3>
42			<table>
43			<tr>
44	schoenebeck	3578	<th>Data Type</th> <th>Description</th>
45	schoenebeck	2966	</tr>
46			<tr>
47	schoenebeck	3578	<td>Integer Number</td>
48	schoenebeck	2966	<td>Bit shifted result.</td>
49			</tr>
50			</table>
51	schoenebeck	3601
52			<h3>Remarks</h3>
53			<p>
54			This functions accepts finalness for its argument <code>??number??</code>.
55			The return value's finalness will be identical to <code>??number??</code>'s one.
56			</p>
57
58	schoenebeck	2966	<h3>Examples</h3>
59			<p/>
60			<code>
61			on init
62			message("sh_right(128,0) = " & sh_right(128,0))
63			message("sh_right(128,1) = " & sh_right(128,1))
64			message("sh_right(128,2) = " & sh_right(128,2))
65			message("sh_right(128,3) = " & sh_right(128,3))
66			end on
67			</code>
68
69	schoenebeck	3244	<h3>See also</h3>
70			<p><code>sh_left()</code><p>
71
72	schoenebeck	3196	<h3>Availability</h3>
73	schoenebeck	2966	<p>Since LinuxSampler 2.0.0.svn22.<p>
74
75			</body>
76			</html>