views/asm-docs-source/PHSUBSW.html - compiler-explorer - Rivoreo Source Code Repositories

 <!DOCTYPE html>

 <html>
 <head>
 <meta charset="UTF-8">
 <link href="style.css" type="text/css" rel="stylesheet">
 <title>PHSUBSW — Packed Horizontal Subtract and Saturate </title></head>
 <body>
 <h1>PHSUBSW — Packed Horizontal Subtract and Saturate</h1>
 <table>
 <tr>
 <th>Opcode/Instruction</th>
 <th>Op/En</th>
 <th>64/32 bit Mode Support</th>
 <th>CPUID Feature Flag</th>
 <th>Description</th></tr>
 <tr>
 <td>
 <p>0F 38 07 /r<sup>1</sup></p>
 <p>PHSUBSW <em>mm1, mm2/m64</em></p></td>
 <td>RM</td>
 <td>V/V</td>
 <td>SSSE3</td>
 <td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>mm1.</em></td></tr>
 <tr>
 <td>
 <p>66 0F 38 07 /r</p>
 <p>PHSUBSW <em>xmm1, xmm2/m128</em></p></td>
 <td>RM</td>
 <td>V/V</td>
 <td>SSSE3</td>
 <td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>xmm1.</em></td></tr>
 <tr>
 <td>
 <p>VEX.NDS.128.66.0F38.WIG 07 /r</p>
 <p>VPHSUBSW <em>xmm1, xmm2, xmm3/m128</em></p></td>
 <td>RVM</td>
 <td>V/V</td>
 <td>AVX</td>
 <td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>xmm1</em>.</td></tr>
 <tr>
 <td>
 <p>VEX.NDS.256.66.0F38.WIG 07 /r</p>
 <p>VPHSUBSW <em>ymm1, ymm2, ymm3/m256</em></p></td>
 <td>RVM</td>
 <td>V/V</td>
 <td>AVX2</td>
 <td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>ymm1</em>.</td></tr></table>
 <p>NOTES:</p>
 <p>1. See note in Section 2.4, “Instruction Exception Specification” in the <em>Intel® 64 and IA-32 Architectures Software Developer’s Manual, Volume 2A</em> and Section 22.25.3, “Exception Conditions of Legacy SIMD Instructions Operating on MMX Registers” in the <em>Intel® 64 and IA-32 Architectures Software Developer’s Manual, Volume 3A</em>.</p>
 <h3>Instruction Operand Encoding</h3>
 <table>
 <tr>
 <td>Op/En</td>
 <td>Operand 1</td>
 <td>Operand 2</td>
 <td>Operand 3</td>
 <td>Operand 4</td></tr>
 <tr>
 <td>RM</td>
 <td>ModRM:reg (r, w)</td>
 <td>ModRM:r/m (r)</td>
 <td>NA</td>
 <td>NA</td></tr>
 <tr>
 <td>RVM</td>
 <td>ModRM:reg (r, w)</td>
 <td>VEX.vvvv (r)</td>
 <td>ModRM:r/m (r)</td>
 <td>NA</td></tr></table>
 <h2>Description</h2>
 <p>(V)PHSUBSW performs horizontal subtraction on each adjacent pair of 16-bit signed integers by subtracting the most significant word from the least significant word of each pair in the source and destination operands. The signed, saturated 16-bit results are packed to the destination operand (first operand). When the source operand is a 128-bit memory operand, the operand must be aligned on a 16-byte boundary or a general-protection exception (#GP) will be generated.</p>
 <p>Legacy SSE version: Both operands can be MMX registers. The second source operand can be an MMX register or a 64-bit memory location.</p>
 <p>128-bit Legacy SSE version: The first source and destination operands are XMM registers. The second source operand is an XMM register or a 128-bit memory location. Bits (VLMAX-1:128) of the corresponding YMM destina-tion register remain unchanged.</p>
 <p>In 64-bit mode, use the REX prefix to access additional registers.</p>
 <p>VEX.128 encoded version: The first source and destination operands are XMM registers. The second source operand is an XMM register or a 128-bit memory location. Bits (VLMAX-1:128) of the destination YMM register are zeroed.</p>
 <p>VEX.256 encoded version: The first source and destination operands are YMM registers. The second source operand can be an YMM register or a 256-bit memory location.</p>
 <p>Note: VEX.L must be 0, otherwise the instruction will #UD.</p>
 <h2>Operation</h2>
 <p><strong>PHSUBSW (with 64-bit operands)</strong></p>
 <pre>    mm1[15-0] = SaturateToSignedWord(mm1[15-0] - mm1[31-16]);
     mm1[31-16] = SaturateToSignedWord(mm1[47-32] - mm1[63-48]);
     mm1[47-32] = SaturateToSignedWord(mm2/m64[15-0] - mm2/m64[31-16]);
     mm1[63-48] = SaturateToSignedWord(mm2/m64[47-32] - mm2/m64[63-48]);</pre>
 <p><strong>PHSUBSW (with 128-bit operands)</strong></p>
 <pre>    xmm1[15-0] = SaturateToSignedWord(xmm1[15-0] - xmm1[31-16]);
     xmm1[31-16] = SaturateToSignedWord(xmm1[47-32] - xmm1[63-48]);
     xmm1[47-32] = SaturateToSignedWord(xmm1[79-64] - xmm1[95-80]);
     xmm1[63-48] = SaturateToSignedWord(xmm1[111-96] - xmm1[127-112]);
     xmm1[79-64] = SaturateToSignedWord(xmm2/m128[15-0] - xmm2/m128[31-16]);
     xmm1[95-80] =SaturateToSignedWord(xmm2/m128[47-32] - xmm2/m128[63-48]);
     xmm1[111-96] =SaturateToSignedWord(xmm2/m128[79-64] - xmm2/m128[95-80]);
     xmm1[127-112]= SaturateToSignedWord(xmm2/m128[111-96] - xmm2/m128[127-112]);</pre>
 <p><strong>VPHSUBSW (VEX.128 encoded version)</strong></p>
 <pre>DEST[15:0]= SaturateToSignedWord(SRC1[15:0] - SRC1[31:16])
 DEST[31:16] = SaturateToSignedWord(SRC1[47:32] - SRC1[63:48])
 DEST[47:32] = SaturateToSignedWord(SRC1[79:64] - SRC1[95:80])
 DEST[63:48] = SaturateToSignedWord(SRC1[111:96] - SRC1[127:112])
 DEST[79:64] = SaturateToSignedWord(SRC2[15:0] - SRC2[31:16])
 DEST[95:80] = SaturateToSignedWord(SRC2[47:32] - SRC2[63:48])
 DEST[111:96] = SaturateToSignedWord(SRC2[79:64] - SRC2[95:80])
 DEST[127:112] = SaturateToSignedWord(SRC2[111:96] - SRC2[127:112])
 DEST[VLMAX-1:128] ← 0</pre>
 <p><strong>VPHSUBSW (VEX.256 encoded version)</strong></p>
 <pre>DEST[15:0]= SaturateToSignedWord(SRC1[15:0] - SRC1[31:16])
 DEST[31:16] = SaturateToSignedWord(SRC1[47:32] - SRC1[63:48])
 DEST[47:32] = SaturateToSignedWord(SRC1[79:64] - SRC1[95:80])
 DEST[63:48] = SaturateToSignedWord(SRC1[111:96] - SRC1[127:112])
 DEST[79:64] = SaturateToSignedWord(SRC2[15:0] - SRC2[31:16])
 DEST[95:80] = SaturateToSignedWord(SRC2[47:32] - SRC2[63:48])
 DEST[111:96] = SaturateToSignedWord(SRC2[79:64] - SRC2[95:80])
 DEST[127:112] = SaturateToSignedWord(SRC2[111:96] - SRC2[127:112])
 DEST[143:128]= SaturateToSignedWord(SRC1[143:128] - SRC1[159:144])
 DEST[159:144] = SaturateToSignedWord(SRC1[175:160] - SRC1[191:176])
 DEST[175:160] = SaturateToSignedWord(SRC1[207:192] - SRC1[223:208])
 DEST[191:176] = SaturateToSignedWord(SRC1[239:224] - SRC1[255:240])
 DEST[207:192] = SaturateToSignedWord(SRC2[143:128] - SRC2[159:144])
 DEST[223:208] = SaturateToSignedWord(SRC2[175:160] - SRC2[191:176])
 DEST[239:224] = SaturateToSignedWord(SRC2[207:192] - SRC2[223:208])
 DEST[255:240] = SaturateToSignedWord(SRC2[239:224] - SRC2[255:240])</pre>
 <h2>Intel C/C++ Compiler Intrinsic Equivalent</h2>
 <p>PHSUBSW:</p>
 <p>__m64 _mm_hsubs_pi16 (__m64 a, __m64 b)</p>
 <p>(V)PHSUBSW:</p>
 <p>__m128i _mm_hsubs_epi16 (__m128i a, __m128i b)</p>
 <p>VPHSUBSW:</p>
 <p>__m256i _mm256_hsubs_epi16 (__m256i a, __m256i b)</p>
 <h2>SIMD Floating-Point Exceptions</h2>
 <p>None.</p>
 <h2>Other Exceptions</h2>
 <p>See Exceptions Type 4; additionally</p>
 <table class="exception-table">
 <tr>
 <td>#UD</td>
 <td>If VEX.L = 1.</td></tr></table></body></html>
	<!DOCTYPE html>

	<html>
	<head>
	<meta charset="UTF-8">
	<link href="style.css" type="text/css" rel="stylesheet">
	<title>PHSUBSW — Packed Horizontal Subtract and Saturate </title></head>
	<body>
	<h1>PHSUBSW — Packed Horizontal Subtract and Saturate</h1>
	<table>
	<tr>
	<th>Opcode/Instruction</th>
	<th>Op/En</th>
	<th>64/32 bit Mode Support</th>
	<th>CPUID Feature Flag</th>
	<th>Description</th></tr>
	<tr>
	<td>
	<p>0F 38 07 /r<sup>1</sup></p>
	<p>PHSUBSW <em>mm1, mm2/m64</em></p></td>
	<td>RM</td>
	<td>V/V</td>
	<td>SSSE3</td>
	<td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>mm1.</em></td></tr>
	<tr>
	<td>
	<p>66 0F 38 07 /r</p>
	<p>PHSUBSW <em>xmm1, xmm2/m128</em></p></td>
	<td>RM</td>
	<td>V/V</td>
	<td>SSSE3</td>
	<td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>xmm1.</em></td></tr>
	<tr>
	<td>
	<p>VEX.NDS.128.66.0F38.WIG 07 /r</p>
	<p>VPHSUBSW <em>xmm1, xmm2, xmm3/m128</em></p></td>
	<td>RVM</td>
	<td>V/V</td>
	<td>AVX</td>
	<td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>xmm1</em>.</td></tr>
	<tr>
	<td>
	<p>VEX.NDS.256.66.0F38.WIG 07 /r</p>
	<p>VPHSUBSW <em>ymm1, ymm2, ymm3/m256</em></p></td>
	<td>RVM</td>
	<td>V/V</td>
	<td>AVX2</td>
	<td>Subtract 16-bit signed integer horizontally, pack saturated integers to <em>ymm1</em>.</td></tr></table>
	<p>NOTES:</p>
	<p>1. See note in Section 2.4, “Instruction Exception Specification” in the <em>Intel® 64 and IA-32 Architectures Software Developer’s Manual, Volume 2A</em> and Section 22.25.3, “Exception Conditions of Legacy SIMD Instructions Operating on MMX Registers” in the <em>Intel® 64 and IA-32 Architectures Software Developer’s Manual, Volume 3A</em>.</p>
	<h3>Instruction Operand Encoding</h3>
	<table>
	<tr>
	<td>Op/En</td>
	<td>Operand 1</td>
	<td>Operand 2</td>
	<td>Operand 3</td>
	<td>Operand 4</td></tr>
	<tr>
	<td>RM</td>
	<td>ModRM:reg (r, w)</td>
	<td>ModRM:r/m (r)</td>
	<td>NA</td>
	<td>NA</td></tr>
	<tr>
	<td>RVM</td>
	<td>ModRM:reg (r, w)</td>
	<td>VEX.vvvv (r)</td>
	<td>ModRM:r/m (r)</td>
	<td>NA</td></tr></table>
	<h2>Description</h2>
	<p>(V)PHSUBSW performs horizontal subtraction on each adjacent pair of 16-bit signed integers by subtracting the most significant word from the least significant word of each pair in the source and destination operands. The signed, saturated 16-bit results are packed to the destination operand (first operand). When the source operand is a 128-bit memory operand, the operand must be aligned on a 16-byte boundary or a general-protection exception (#GP) will be generated.</p>
	<p>Legacy SSE version: Both operands can be MMX registers. The second source operand can be an MMX register or a 64-bit memory location.</p>
	<p>128-bit Legacy SSE version: The first source and destination operands are XMM registers. The second source operand is an XMM register or a 128-bit memory location. Bits (VLMAX-1:128) of the corresponding YMM destina-tion register remain unchanged.</p>
	<p>In 64-bit mode, use the REX prefix to access additional registers.</p>
	<p>VEX.128 encoded version: The first source and destination operands are XMM registers. The second source operand is an XMM register or a 128-bit memory location. Bits (VLMAX-1:128) of the destination YMM register are zeroed.</p>
	<p>VEX.256 encoded version: The first source and destination operands are YMM registers. The second source operand can be an YMM register or a 256-bit memory location.</p>
	<p>Note: VEX.L must be 0, otherwise the instruction will #UD.</p>
	<h2>Operation</h2>
	<p><strong>PHSUBSW (with 64-bit operands)</strong></p>
	<pre> mm1[15-0] = SaturateToSignedWord(mm1[15-0] - mm1[31-16]);
	mm1[31-16] = SaturateToSignedWord(mm1[47-32] - mm1[63-48]);
	mm1[47-32] = SaturateToSignedWord(mm2/m64[15-0] - mm2/m64[31-16]);
	mm1[63-48] = SaturateToSignedWord(mm2/m64[47-32] - mm2/m64[63-48]);</pre>
	<p><strong>PHSUBSW (with 128-bit operands)</strong></p>
	<pre> xmm1[15-0] = SaturateToSignedWord(xmm1[15-0] - xmm1[31-16]);
	xmm1[31-16] = SaturateToSignedWord(xmm1[47-32] - xmm1[63-48]);
	xmm1[47-32] = SaturateToSignedWord(xmm1[79-64] - xmm1[95-80]);
	xmm1[63-48] = SaturateToSignedWord(xmm1[111-96] - xmm1[127-112]);
	xmm1[79-64] = SaturateToSignedWord(xmm2/m128[15-0] - xmm2/m128[31-16]);
	xmm1[95-80] =SaturateToSignedWord(xmm2/m128[47-32] - xmm2/m128[63-48]);
	xmm1[111-96] =SaturateToSignedWord(xmm2/m128[79-64] - xmm2/m128[95-80]);
	xmm1[127-112]= SaturateToSignedWord(xmm2/m128[111-96] - xmm2/m128[127-112]);</pre>
	<p><strong>VPHSUBSW (VEX.128 encoded version)</strong></p>
	<pre>DEST[15:0]= SaturateToSignedWord(SRC1[15:0] - SRC1[31:16])
	DEST[31:16] = SaturateToSignedWord(SRC1[47:32] - SRC1[63:48])
	DEST[47:32] = SaturateToSignedWord(SRC1[79:64] - SRC1[95:80])
	DEST[63:48] = SaturateToSignedWord(SRC1[111:96] - SRC1[127:112])
	DEST[79:64] = SaturateToSignedWord(SRC2[15:0] - SRC2[31:16])
	DEST[95:80] = SaturateToSignedWord(SRC2[47:32] - SRC2[63:48])
	DEST[111:96] = SaturateToSignedWord(SRC2[79:64] - SRC2[95:80])
	DEST[127:112] = SaturateToSignedWord(SRC2[111:96] - SRC2[127:112])
	DEST[VLMAX-1:128] ← 0</pre>
	<p><strong>VPHSUBSW (VEX.256 encoded version)</strong></p>
	<pre>DEST[15:0]= SaturateToSignedWord(SRC1[15:0] - SRC1[31:16])
	DEST[31:16] = SaturateToSignedWord(SRC1[47:32] - SRC1[63:48])
	DEST[47:32] = SaturateToSignedWord(SRC1[79:64] - SRC1[95:80])
	DEST[63:48] = SaturateToSignedWord(SRC1[111:96] - SRC1[127:112])
	DEST[79:64] = SaturateToSignedWord(SRC2[15:0] - SRC2[31:16])
	DEST[95:80] = SaturateToSignedWord(SRC2[47:32] - SRC2[63:48])
	DEST[111:96] = SaturateToSignedWord(SRC2[79:64] - SRC2[95:80])
	DEST[127:112] = SaturateToSignedWord(SRC2[111:96] - SRC2[127:112])
	DEST[143:128]= SaturateToSignedWord(SRC1[143:128] - SRC1[159:144])
	DEST[159:144] = SaturateToSignedWord(SRC1[175:160] - SRC1[191:176])
	DEST[175:160] = SaturateToSignedWord(SRC1[207:192] - SRC1[223:208])
	DEST[191:176] = SaturateToSignedWord(SRC1[239:224] - SRC1[255:240])
	DEST[207:192] = SaturateToSignedWord(SRC2[143:128] - SRC2[159:144])
	DEST[223:208] = SaturateToSignedWord(SRC2[175:160] - SRC2[191:176])
	DEST[239:224] = SaturateToSignedWord(SRC2[207:192] - SRC2[223:208])
	DEST[255:240] = SaturateToSignedWord(SRC2[239:224] - SRC2[255:240])</pre>
	<h2>Intel C/C++ Compiler Intrinsic Equivalent</h2>
	<p>PHSUBSW:</p>
	<p>__m64 _mm_hsubs_pi16 (__m64 a, __m64 b)</p>
	<p>(V)PHSUBSW:</p>
	<p>__m128i _mm_hsubs_epi16 (__m128i a, __m128i b)</p>
	<p>VPHSUBSW:</p>
	<p>__m256i _mm256_hsubs_epi16 (__m256i a, __m256i b)</p>
	<h2>SIMD Floating-Point Exceptions</h2>
	<p>None.</p>
	<h2>Other Exceptions</h2>
	<p>See Exceptions Type 4; additionally</p>
	<table class="exception-table">
	<tr>
	<td>#UD</td>
	<td>If VEX.L = 1.</td></tr></table></body></html>