Skip to content

Commit 433aba0

Browse files
ghogenghogen
authored
Merge pull request MicrosoftDocs#7 from Microsoft/migration
Migration
2 parents 5e8c65a + 8bc0a0e commit 433aba0

26,407 files changed

Lines changed: 1205496 additions & 1164674 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/TOC.md‎

Lines changed: 41 additions & 10984 deletions
Large diffs are not rendered by default.

‎docs/assembler/arm/TOC.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# [ARM Assembler Reference](arm-assembler-reference.md)
2+
# [ARM Assembler Command-Line Reference](arm-assembler-command-line-reference.md)
3+
# [ARM Assembler Directives](arm-assembler-directives.md)
4+
# [ARM Assembler Diagnostic Messages](arm-assembler-diagnostic-messages.md)

docs/intrinsics/arm-assembler-command-line-reference.md renamed to docs/assembler/arm/arm-assembler-command-line-reference.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
---
22
title: "ARM Assembler Command-Line Reference"
3-
ms.custom: na
4-
ms.date: "10/14/2016"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
55
ms.prod: "visual-studio-dev14"
6-
ms.reviewer: na
7-
ms.suite: na
6+
ms.reviewer: ""
7+
ms.suite: ""
88
ms.technology:
99
- "devlang-cpp"
10-
ms.tgt_pltfrm: na
10+
ms.tgt_pltfrm: ""
1111
ms.topic: "article"
1212
dev_langs:
1313
- "C++"
1414
ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
1515
caps.latest.revision: 12
16+
author: "corob-msft"
1617
ms.author: "corob"
1718
manager: "ghogen"
1819
translation.priority.ht:
@@ -103,5 +104,5 @@ armasm [[options]] -o objectfile sourcefile
103104
**cl myccode.c /link myasmcode.obj**
104105

105106
## See Also
106-
[ARM Assembler Diagnostic Messages](../intrinsics/arm-assembler-diagnostic-messages.md)
107-
[ARM Assembler Directives](../intrinsics/arm-assembler-directives.md)
107+
[ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)
108+
[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)

docs/intrinsics/arm-assembler-diagnostic-messages.md renamed to docs/assembler/arm/arm-assembler-diagnostic-messages.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
---
22
title: "ARM Assembler Diagnostic Messages"
3-
ms.custom: na
4-
ms.date: "10/14/2016"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
55
ms.prod: "visual-studio-dev14"
6-
ms.reviewer: na
7-
ms.suite: na
6+
ms.reviewer: ""
7+
ms.suite: ""
88
ms.technology:
99
- "devlang-cpp"
10-
ms.tgt_pltfrm: na
10+
ms.tgt_pltfrm: ""
1111
ms.topic: "article"
1212
dev_langs:
1313
- "C++"
1414
ms.assetid: 52b38267-6023-4bdc-a0ef-863362f48eec
1515
caps.latest.revision: 6
16+
author: "corob-msft"
1617
ms.author: "corob"
1718
manager: "ghogen"
1819
translation.priority.ht:
@@ -137,5 +138,5 @@ ADDEQ r0, r1, r8 ; A4509: This form of conditional instruction is d
137138
```
138139

139140
## See Also
140-
[ARM Assembler Command-Line Reference](../intrinsics/arm-assembler-command-line-reference.md)
141-
[ARM Assembler Directives](../intrinsics/arm-assembler-directives.md)
141+
[ARM Assembler Command-Line Reference](../../assembler/arm/arm-assembler-command-line-reference.md)
142+
[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)

docs/intrinsics/arm-assembler-directives.md renamed to docs/assembler/arm/arm-assembler-directives.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,19 @@
11
---
22
title: "ARM Assembler Directives"
3-
ms.custom: na
4-
ms.date: "10/14/2016"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
55
ms.prod: "visual-studio-dev14"
6-
ms.reviewer: na
7-
ms.suite: na
6+
ms.reviewer: ""
7+
ms.suite: ""
88
ms.technology:
99
- "devlang-cpp"
10-
ms.tgt_pltfrm: na
10+
ms.tgt_pltfrm: ""
1111
ms.topic: "article"
1212
dev_langs:
1313
- "C++"
1414
ms.assetid: 9cfa8896-ec10-4e77-855a-3135c40d7d2a
1515
caps.latest.revision: 5
16+
author: "corob-msft"
1617
ms.author: "corob"
1718
manager: "ghogen"
1819
translation.priority.ht:
@@ -121,5 +122,5 @@ IMPORT sym{, WEAK alias{, TYPE t}}
121122
Not supported because the Microsoft ARM assembler does not support the Thumb-2EE instruction set.
122123

123124
## See Also
124-
[ARM Assembler Command-Line Reference](../intrinsics/arm-assembler-command-line-reference.md)
125-
[ARM Assembler Diagnostic Messages](../intrinsics/arm-assembler-diagnostic-messages.md)
125+
[ARM Assembler Command-Line Reference](../../assembler/arm/arm-assembler-command-line-reference.md)
126+
[ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)

‎docs/assembler/arm/arm-assembler-reference.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: "ARM Assembler Reference"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
5+
ms.prod: "visual-studio-dev14"
6+
ms.reviewer: ""
7+
ms.suite: ""
8+
ms.technology:
9+
- "devlang-cpp"
10+
ms.tgt_pltfrm: ""
11+
ms.topic: "article"
12+
dev_langs:
13+
- "C++"
14+
ms.assetid: f8a076cc-9627-4328-a34a-9c44f7a3aab1
15+
caps.latest.revision: 13
16+
author: "corob-msft"
17+
ms.author: "corob"
18+
manager: "ghogen"
19+
translation.priority.ht:
20+
- "cs-cz"
21+
- "de-de"
22+
- "es-es"
23+
- "fr-fr"
24+
- "it-it"
25+
- "ja-jp"
26+
- "ko-kr"
27+
- "pl-pl"
28+
- "pt-br"
29+
- "ru-ru"
30+
- "tr-tr"
31+
- "zh-cn"
32+
- "zh-tw"
33+
---
34+
# ARM Assembler Reference
35+
The articles in this section of the documentation provide reference material for the Microsoft ARM assembler (armasm) and related tools.
36+
37+
## Related Articles
38+
39+
|Title|Description|
40+
|-----------|-----------------|
41+
|[ARM Assembler Command-Line Reference](../../assembler/arm/arm-assembler-command-line-reference.md)|Describes the armasm command-line options.|
42+
|[ARM Assembler Diagnostic Messages](../../assembler/arm/arm-assembler-diagnostic-messages.md)|Describes commonly encountered armasm warning and error messages.|
43+
|[ARM Assembler Directives](../../assembler/arm/arm-assembler-directives.md)|Describes the ARM directives that are different in armasm.|
44+
|[ARM Architecture Reference Manual](http://go.microsoft.com/fwlink/?LinkId=246464) on the ARM Infocenter website.|Contains additional information about the ARM assembly language.|
45+
|[ARM Assembler Tools Guide](http://go.microsoft.com/fwlink/?LinkId=246102) on the ARM Infocenter website.|Contains reference sections about ARM, Thumb, NEON, and VFP. **Note:** The "armasm" assembler that is referred to on the ARM Infocenter website is not the Microsoft asmasm assembler that is included in Visual Studio and is documented in this section.|
46+
47+
## See Also
48+
[ARM Intrinsics](../../intrinsics/arm-intrinsics.md)
49+
[Compiler Intrinsics](../../intrinsics/compiler-intrinsics.md)

‎docs/assembler/inline/TOC.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# [Data Directives and Operators in Inline Assembly](data-directives-and-operators-in-inline-assembly.md)
2+
# [Calling C Functions in Inline Assembly](calling-c-functions-in-inline-assembly.md)
3+
# [Accessing C or C++ Data in __asm Blocks](accessing-c-or-cpp-data-in-asm-blocks.md)
4+
# [Using and Preserving Registers in Inline Assembly](using-and-preserving-registers-in-inline-assembly.md)
5+
# [Inline Assembler Overview](inline-assembler-overview.md)
6+
# [MASM Expressions in Inline Assembly](masm-expressions-in-inline-assembly.md)
7+
# [Segment References in Inline Assembly](segment-references-in-inline-assembly.md)
8+
# [Type and Variable Sizes in Inline Assembly](type-and-variable-sizes-in-inline-assembly.md)
9+
# [Writing Functions with Inline Assembly](writing-functions-with-inline-assembly.md)
10+
# [Using C or C++ in __asm Blocks](using-c-or-cpp-in-asm-blocks.md)
11+
# [Using Assembly Language in __asm Blocks](using-assembly-language-in-asm-blocks.md)
12+
# [Instruction Set for Inline Assembly](instruction-set-for-inline-assembly.md)
13+
# [Using Operators in __asm Blocks](using-operators-in-asm-blocks.md)
14+
# [Advantages of Inline Assembly](advantages-of-inline-assembly.md)
15+
# [MASM Macro Directives in Inline Assembly](masm-macro-directives-in-inline-assembly.md)
16+
# [Inline Assembler](inline-assembler.md)
17+
# [__asm](asm.md)
18+
# [EVEN and ALIGN Directives](even-and-align-directives.md)
19+
# [Intel's MMX Instruction Set](intel-s-mmx-instruction-set.md)
20+
# [Debugging and Listings for Inline Assembly](debugging-and-listings-for-inline-assembly.md)
21+
# [Defining __asm Blocks as C Macros](defining-asm-blocks-as-c-macros.md)
22+
# [Optimizing Inline Assembly](optimizing-inline-assembly.md)
23+
# [Jumping to Labels in Inline Assembly](jumping-to-labels-in-inline-assembly.md)
24+
# [Calling C++ Functions in Inline Assembly](calling-cpp-functions-in-inline-assembly.md)
25+
# [Assembly-Language Comments](assembly-language-comments.md)
26+
# [Using C or C++ Symbols in __asm Blocks](using-c-or-cpp-symbols-in-asm-blocks.md)
27+
# [_emit Pseudoinstruction](emit-pseudoinstruction.md)

‎docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: "Accessing C or C++ Data in __asm Blocks"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
5+
ms.prod: "visual-studio-dev14"
6+
ms.reviewer: ""
7+
ms.suite: ""
8+
ms.technology:
9+
- "devlang-cpp"
10+
ms.tgt_pltfrm: ""
11+
ms.topic: "article"
12+
dev_langs:
13+
- "C++"
14+
helpviewer_keywords:
15+
- "data members [C++], in __asm blocks"
16+
- "data access [C++], in __asm blocks"
17+
- "__asm keyword [C++], data members"
18+
- "structure types in __asm blocks"
19+
ms.assetid: e99f5a28-0381-4090-8ece-6af8f2436a49
20+
caps.latest.revision: 7
21+
author: "corob-msft"
22+
ms.author: "corob"
23+
manager: "ghogen"
24+
translation.priority.ht:
25+
- "cs-cz"
26+
- "de-de"
27+
- "es-es"
28+
- "fr-fr"
29+
- "it-it"
30+
- "ja-jp"
31+
- "ko-kr"
32+
- "pl-pl"
33+
- "pt-br"
34+
- "ru-ru"
35+
- "tr-tr"
36+
- "zh-cn"
37+
- "zh-tw"
38+
---
39+
# Accessing C or C++ Data in __asm Blocks
40+
## Microsoft Specific
41+
A great convenience of inline assembly is the ability to refer to C or C++ variables by name. An `__asm` block can refer to any symbols, including variable names, that are in scope where the block appears. For instance, if the C variable `var` is in scope, the instruction
42+
43+
```
44+
__asm mov eax, var
45+
```
46+
47+
stores the value of `var` in EAX.
48+
49+
If a class, structure, or union member has a unique name, an `__asm` block can refer to it using only the member name, without specifying the variable or `typedef` name before the period (**.**) operator. If the member name is not unique, however, you must place a variable or `typedef` name immediately before the period operator. For example, the structure types in the following sample share `same_name` as their member name:.
50+
51+
If you declare variables with the types
52+
53+
```
54+
struct first_type hal;
55+
struct second_type oat;
56+
```
57+
58+
all references to the member `same_name` must use the variable name because `same_name` is not unique. But the member `weasel` has a unique name, so you can refer to it using only its member name:
59+
60+
```
61+
// InlineAssembler_Accessing_C_asm_Blocks.cpp
62+
// processor: x86
63+
#include <stdio.h>
64+
struct first_type
65+
{
66+
char *weasel;
67+
int same_name;
68+
};
69+
70+
struct second_type
71+
{
72+
int wonton;
73+
long same_name;
74+
};
75+
76+
int main()
77+
{
78+
struct first_type hal;
79+
struct second_type oat;
80+
81+
__asm
82+
{
83+
lea ebx, hal
84+
mov ecx, [ebx]hal.same_name ; Must use 'hal'
85+
mov esi, [ebx].weasel ; Can omit 'hal'
86+
}
87+
return 0;
88+
}
89+
```
90+
91+
Note that omitting the variable name is merely a coding convenience. The same assembly instructions are generated whether or not the variable name is present.
92+
93+
You can access data members in C++ without regard to access restrictions. However, you cannot call member functions.
94+
95+
**END Microsoft Specific**
96+
97+
## See Also
98+
[Using C or C++ in __asm Blocks](../../assembler/inline/using-c-or-cpp-in-asm-blocks.md)

docs/intrinsics/advantages-of-inline-assembly.md renamed to docs/assembler/inline/advantages-of-inline-assembly.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: "Advantages of Inline Assembly"
3-
ms.custom: na
4-
ms.date: "10/14/2016"
3+
ms.custom: ""
4+
ms.date: "10/28/2016"
55
ms.prod: "visual-studio-dev14"
6-
ms.reviewer: na
7-
ms.suite: na
6+
ms.reviewer: ""
7+
ms.suite: ""
88
ms.technology:
99
- "devlang-cpp"
10-
ms.tgt_pltfrm: na
10+
ms.tgt_pltfrm: ""
1111
ms.topic: "article"
1212
dev_langs:
1313
- "C++"
@@ -17,6 +17,7 @@ helpviewer_keywords:
1717
- "inline assembly [C++], using"
1818
ms.assetid: 94364d97-faa7-4bdf-8473-570956986c51
1919
caps.latest.revision: 7
20+
author: "corob-msft"
2021
ms.author: "corob"
2122
manager: "ghogen"
2223
translation.priority.ht:
@@ -53,4 +54,4 @@ translation.priority.ht:
5354
**END Microsoft Specific**
5455

5556
## See Also
56-
[Inline Assembler](../intrinsics/inline-assembler.md)
57+
[Inline Assembler](../../assembler/inline/inline-assembler.md)

0 commit comments

Comments
 (0)